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Web 相 关 基 础 技术 ， 如 HTML、CSS、JavaScript， 以 及 Django 开 发 框架 
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Foreword 前 


写作 本 书 的 初衷 

不 知 不 觉 间 我 已 经 大 学 毕业 快 十 年 了 ， 从 刚 毕 业 踏 入 软件 开发 行列 算 起 ， 大 大 小 小 的 项 
目 也 参与 或 主导 了 不 少 ， 从 最 开始 的 职场 新 人 到 能 够 指导 别人 做 项 目 ， 这 期 间 经 历 了 太 多 事 
情 ， 也 有 过 太 多 的 曲折 。 

生活 中 经 历 过 的 每 一 家 公司 、 合 作 过 的 每 一 个 同事 都 给 予 我 不 同 的 成 长 经 验 。 作 为 一 名 
标准 的 程序 员 ， 我 也 有 过 加 班 熬夜 只 为 了 解决 一 个 技术 问题 的 狂热 ， 我 也 会 接 一 些 私 活 而 不 
是 为 了 能 够 挣 多 少 钱 ， 只 为 了 多 一 些 提 升 自身 技术 水 平 的 机 会 。 记 得 刚 毕 业 的 时 候 ， 我 经 常 
去 Slaspx、 蓝 色 理 想 论 坛 等 下 载 源码 ， 把 它们 一 一 看 透 并 用 自己 的 方式 实现 。 当 我 还 沉浸 在 
这 种 技术 学 习 方式 的 时 候 ， 老 同事 贺 春 波 的 一 句 话 如 当头 棒 喝 一 样 使 我 为 自己 定 下 一 个 新 的 
目标 ， 那 就 是 要 做 出 一 款 自 己 的 产品 或 出 版 一 本 自己 的 书 。 记 得 当时 我 们 聊 到 软件 开发 的 时 
候 ， 我 说 :“ 我 正在 开发 一 个 Web 应 用 框架 ， 和 希望 这 个 框架 能 够 做 到 尽 可 能 通用 ， 这 样 当 我 
再 接 私 活 的 时 候 就 可 以 不 用 再 做 很 多 重复 的 工作 了 -.” 贺 春 波 说 :“ 框 架 是 一 个 很 好 的 东西 ， 
很 多 开发 人 员 都 会 做 ， 也 都 做 过 ， 但 是 真正 能 做 出 来 的 人 很 少 ， 这 也 是 很 多 开发 人 员 的 通 
病 : 做 事 不 能 坚持 。” 当 时 我 就 在 想 ， 是 呀 ， 我 都 已 经 为 自己 定 过 多 少 个 目标 了 ? 单 就 开发 
Web 应 用 框架 这 一 件 事情 ， 我 就 做 了 好 几 次 ， 每 次 都 是 做 一 点 就 放弃 了 。 难 道 当 我 工作 很 多 
年 之 后 ， 回 忆 自 己 的 成 长 历程 时 ， 留 下 的 记忆 只 能 是 那些 做 了 一 半 的 半成品 吗 ? 难道 就 像 那 
个 笑话 说 的 : 本 人 能 够 熟练 书写 JavaScript, C++, Java, C# 3? 

在 我 的 内 心中 一 直 有 两 个 目标 : 开发 一 款 个 人 应 用 和 出 版 一 本 个 人 书籍 。 这 两 件 事情 对 
我 来 说 都 不 简单 ， 开 发 应 用 程序 一 定 要 有 真实 的 使 用 场景 ， 能 够 为 具体 人 群 解决 实际 问题 ， 
也 正 因 为 如 此 ， 这 件 事情 迟 迟 没有 开始 。 第 二 件 事 情 相 对 简单 多 了 ， 每 一 个 开发 人 员 都 曾 
学 习 过 很 多 种 技术 ， 每 一 种 技术 又 有 很 多 细 分 领域 。 这 些 细 分 领域 的 学 习 过 程 就 是 从 陌生 到 
熟练 的 过 程 ， 每 一 个 感悟 都 是 后 来 者 的 宝贵 经 验 ， 而 这 些 细 分 领域 往往 又 缺少 足够 的 中 文 资 
料 ， 如 果 我 能 够 把 自己 的 学 习 历 程 记录 下 来 ， 一 定 能 够 为 后 来 者 提供 帮助 与 借鉴 。 

再 者 ， 开 发 人 员 的 一 个 通病 就 是 碎片 化 学 习 ， 尤 其 是 当前 知识 大 爆炸 的 时 代 ， 可 以 通过 
很 多 途径 学 习 知 识 ， 例 如 网 络 论坛 、 技 术 大 牛 的 个 人 博客 、 头 条 推送 的 技术 文章 等 。 通 过 这 
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种 途径 所 学 习 到 的 知识 都 是 零散 的 ， 以 此 不 能 使 我 们 成 为 技术 大 牛 。 我 也 有 成 为 技术 大 牛 的 
梦想 ， 但 是 一 直 以 来 浑 浑 疆 于 ， 直 到 开始 学 习 Django， 我 想 是 时 候 完 成 自己 的 一 个 小 目标 
了 ， 这 就 是 把 我 的 学 习 经 历 记 录 下 来 ， 汇 总 成 一 本 书 ， 使 每 一 位 新 接触 Django 的 人 都 能 
我 的 书 中 得 到 帮助 ， 同 时 通过 系统 的 学 习 使 我 本 人 能 够 更 深入 地 理解 Django。 

读者 对 象 

m Django 框架 的 使 用 者 和 爱好 者 ; 

n 初级 Web 开发 爱好 者 ; 

m Python 开发 人 员 以 及 运 维 人 员 ; 

a 大 中 专 院 校 学 生 。 

如 何 阅读 本 书 

按照 循序 渐进 的 学 习 方 法 ， 本 书 共 分 为 三 部 分 : 

第 一 部 分 为 Python 基础 ， 简 单 介 绍 Python 语言 的 特性 并 给 出 相应 的 代码 示例 ， 非 常 适 
合 初学 者 或 者 没有 Python 语言 开发 基础 的 读者 入 门 学 习 。 

第 二 部 分 为 Web 编程 基础 ， 这 部 分 包含 HTML 基础 、CSS 基础 、JavaScript 基础 和 
MySQL 基础 等 ， 通 过 学 习 这 部 分 内 容 ， 可 以 使 读者 整体 了 解 Web 开发 技术 。 

第 三 部 分 为 Django 框架 ， 详细 介 绍 Django 框架 的 具体 内 容 ， 针 对 每 一 个 知识 点 都 给 出 
具体 代码 示例 ， 可 以 使 读者 快速 认识 Django。 

本 书 各 部 分 相对 独立 ， 如 果 读 者 非常 了 解 Python 语言 或 者 Web 编程 基础 ， 那 么 可 以 跳 
过 第 一 部 分 或 第 二 部 分 ， 直 接 开 始 第 三 部 分 Django 框架 的 学 习 , 但 是 前 两 部 分 仍然 可 以 作 
为 工具 使 用 。 对 于 Python 语言 的 初学 者 或 者 Web 开发 初学 者 ， 强 烈 建议 从 第 1 章 开始 学 习 ， 
并 跟随 本 书 完成 全 部 示例 代码 。 

致谢 

从 开始 着 手写 书 到 完成 ， 差 不 多 过 去 了 半年 时 间 ， 回 顾 这 半年 的 经 历 真 的 是 感慨 万 千 ， 
民 难 想象 我 居然 能 够 坚持 下 来 ， 这 半年 中 很 多 个 夜晚 都 是 在 调试 代码 中 度 过 的 ， 对 于 书 中 的 
j 一 个 示例 都 要 保证 能 够 调试 通过 ， 这 真 的 不 是 一 件 简单 的 事情 ， 还 好 最 终 坚 持 了 下 来 。 忆 
苦 思 甜 的 同时 还 要 感谢 以 下 单位 以 及 个 人 对 我 的 帮助 。 

首先 ， 要 感谢 的 就 是 清华 大 学 出 版 社 ， 是 他 们 给 了 我 这 个 机 会 ， 接 收 我 的 作品 ， 并 以 严 
谨 的 态度 为 我 进行 审 稿 排版 ， 使 本 书 能 够 以 更 高 的 质量 呈现 在 读者 面前 ， 感 谢 每 一 位 编辑 老 
师 在 本 书 出 版 过 程 中 的 辛勤 付出 。 
其 次 ， 要 感谢 我 的 大 学 : 北京 建筑 工程 学 院 ， 现 在 的 北京 建筑 大 学 。 虽 然 她 不 是 一 所 重 
点 大 学 ， 但 是 学 校 中 的 很 多 老师 都 给 过 我 热心 的 帮助 ， 使 我 能 够 顺利 完成 学 业 。 这 其 中 要 着 
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重 感谢 几 位 老师 ， 他 们 是 : 翟 伟 老 师 、 詹 宏伟 老师 、 田 芳 老 师 、 张 翰 涛 老师 和 魏 楚 元 老师 。 
他 们 在 我 心中 永远 是 最 优秀 的 人 民 教 师 。 

另外 ， 还 要 感谢 我 的 研究 生 院 校 : 北京 大 学 医学 部 。 北 京 大 学 医学 部 虽然 不 是 一 所 计算 
机 类 院 校 ， 同 时 在 学 校 的 学 习 过 程 中 也 没 能 在 计算 机 技能 方面 给 予 我 任何 帮助 ， 但 是 通过 在 
这 里 的 学 习 加 强 了 我 做 学 问 的 严谨 性 ， 使 我 能 够 严格 约束 自己 ， 这 在 写作 本 书 的 过 程 中 得 到 
了 体现 。 每 当 我 坚持 不 下 去 的 时 候 ， 都 能 想到 我 的 导师 简 伟 研 老师 的 教导 ， 非 常 感谢 他 。 

还 要 感谢 工作 中 的 同事 和 和 领导， 如 第 一 家 公司 的 直接 领导 李子 佳 经 理 。 李 子 佳 是 我 毕业 
后 参加 的 第 一 份 工作 的 直接 领导 。 那 个 时 候 的 我 可 以 说 是 一 张 白 纸 ， 技 术 功底 欠缺 ， 在 李子 
佳 以 及 其 他 同事 的 帮助 下 ， 我 的 技术 水 平 得 到 快速 提升 ， 这 也 为 我 后 来 的 发 展 打 下 了 坚实 的 
基础 。 还 要 感谢 现在 的 公司 亚 帝 文 软件 (北京 ) 有 限 公 司 ， 这 是 一 家 开放 友好 的 技术 公司 ， 
公司 中 有 很 多 技术 高 手 ， 在 这 里 我 得 到 了 很 多 学 习 机 会 。 

最 后 要 感谢 Django 项 目 组 、W3School、runoob.com 以 及 众多 的 国内 技术 论坛 为 我 完成 
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第 1 章 
Python AT] 


本 章 通过 介绍 Python 语言 的 基础 知识 并 结合 恰当 的 代码 示例 ， 使 读者 快速 掌握 Python 
语言 ， 为 后 面 学 习 Django 开发 打下 基础 。 本 章 内 容 仅 包含 Python 语言 最 基本 的 概念 和 用 法 ， 
适用 于 Python 初学 者 ， 对 于 具有 丰富 经 验 的 Python 开发 人 员 来 说 可 以 跳 过 本 章 内 容 ， 但 是 
仍然 可 以 将 本 章 内 容 当 作 工 具 字典 来 使 用 。 本 章 主要 内 容 : Python 语言 的 历史 、 变 量 、 运 算 
符 、 流 程控 制 语句 、 函 数 、 异 常 处 理 、 面 向 对 象 概念 。 


EE Python 简介 


Python 是 目前 最 流行 的 一 门 软 件 编程 语言 。 随 着 大 数据 、 人 工 智能 等 新 兴 领 域 的 发 展 ， 
越 来 越 多 的 程序 员 开 始 关注 和 使 用 Python 语言 。 

根据 最 新 的 IEEE Spectrum 编程 语言 排行 显示 ,Python 一举 超越 C、C++、Java、 
JavaScript, CH 等 老牌 编程 语言 成 为 2017 年 最 受 欢迎 的 编程 语言 ， 如 图 1-1 所 示 。 
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RE 2017 ^E 10 月 ， 最 新 的 Python 发 布 版 本 分 别 是 Python 2.7.14 和 了 Python 3.6.3, ifii 
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Python 2.x 版 本 将 逐渐 被 Python 3.x 版 本 所 蔡 代 ，Python 3.x 才 是 Python 的 未 来 趋势 。 

Python 2.x 的 最 终 版 本 是 Python 2.7。 它 发 布 于 2010 年 ， 之 后 将 不 会 继续 推出 Python 
2x 的 主 版 本 了 。Python 3.0 最 早 发 布 于 2008 年 ， 经 过 5 年 以 上 的 发 展 ， 已 经 推出 了 很 多 稳 
定 版 本 ， 包 括 2012 年 的 Python 3.3 fi, 2014 年 的 Python 3.4 版 、2015 年 的 Python 3.5 版 以 
及 2016 年 的 Python 3.6 版 。Python 3.x 版 本 已 经 成 为 Python 未 来 的 发 展 趋势 ，Python 3.6 已 
经 能 够 完美 支持 所 有 Python 包 ， 尤 其 是 部 分 Python 包 仅 支持 Python 3.x 版 本 。 

除 特殊 说 明 外 ， 本 书 全 部 示例 代码 均 基 于 Python 3.6.3. 


1.2 | Python 开发 环境 搭建 


Python 下 载 地 址 为 https:Wwww.python.org/downloads/， 如 图 1-2 所 示 


Download the latest versions of Python 


Download Python 3.6.4 | Download Python 2.7.14 


Wondering which version to use? H bout the difference 
Python 2 and 3 
r Python with a different OS? Python for 


Linu. S X, Other 


Want to help test development versions of Python? Pre-releases 


图 1-2 

用 户 可 以 根据 自身 操作 系统 选择 不 同 的 安装 方式 。 为 了 照顾 大 多 数 读者 ， 本 书 采用 
Windows 平台 作为 演示 系统 。 
1.2.1 在 Linux 系统 中 搭建 Python 开发 环境 

由 于 现在 大 多 数 Linux 操作 系统 所 自 带 的 Python 版 本 都 比较 旧 ， 因 此 需要 查看 已 有 
Python 版 本 ， 对 旧版 本 进行 升级 ， 使 用 以 下 命令 查看 Python 版 本 : 

* python --version 

在 Linux 终端 执行 以 下 命令 安装 最 新 版 本 的 Python 可 能 的 依赖 包 : 

# yum install openssl-devel bzip2-devel expat-devel gdbm-devel readline-devel sqlite-devel 


安装 结束 后 如 图 1-3 所 示 。 
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Installed: 
bzip2-devel.xB6 64 0:1.0.5-7.e16 0 expat-devel.x86 64 0:2.0.1-13.e16 8 — gdbm-devel.x86 64 0:1.8.0-39.e16 cpenssl-devel.xB6 64 0:1.0.1e-57.e16 
readline-devel.x86 64 0:6.0-4.e16 sglite-devel.x&6 64 0:3.6.20-1.e16 7.2 


et liba devel.i X86 64 0:1.4-5.e16 krbS-devel.x86 64 0:1.10.3-65.e16 libcom err-devel.x&é 6 


Tibkadns.a96 64 071.10.5-65.e18 lipselingr devel. x86 $4 0:2.0.94-7.e1€  Libsepol-devel x06 6i 
ncurses devel x86 64 0:5.7-4.20090207,e16 — —— alib -devel.aé 6i 0:1.2.5 29.019 

Dependency Updated: 
e2fsprogs.x86 64 0:1.41.12-23.e16 e2fsprogs-libs.x86 64 0:1.41.12-23.e16 expat.x86 64 0:2.0.1-13.e16 8 
gdbm.x56 64 0:1.8.0-39.e16 keyutils-libs.x86 64 0:1.4-5.e16 krbS-libs.x86 64 0:1.10.3-65.e1i 
libcom err.x86 64 0:1.41.12-23.e16 libselinux.x86 64 0:2.0.94-7.e16 libselinux-python.x86 64 0:2.0. $c elé 
Xibselinmx utils-x56 64 012.0.94-7.e16 libss.aié 64 071.41.12-23.e16 acurses-bast x56 64 015.7-4.20090207-e16 
acurses-libs.RÀ 64 :5.7-4.20090207.016 pensi x86 64 011.0.1e-57.e16 sqlite xee 64 005.6.20-1.e16 7.2 
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13 
执行 以 下 命令 下 载 Python 安装 包 : 


束 ， 执 行 以 下 命令 ， 建 立 软 连接 : 


安装 结束 ， 执 行 
© $üncsfusrflocal/bin/pythoni/esr/bin/python 000 


如 果 提 示 Python 文件 已 经 存在 ， 需 要 使 用 以 下 命令 删除 它 : 


检查 Python 版 本 : 


[root@localhost ~]# python --version 
Python 3.6.4 
[root@localhost ~]# J 


至 此 Python 3 安装 完成 。 


1.2[2 在 Windows 系统 中 搭建 Python 开发 环境 


首先 下 载 Python 安装 包 ， 右 击 安装 包 文件 ,选择 “以 管理 员 身 份 运行 ” 。 进 入 Python 安 
装 向 导 ， 推 荐 自 定义 安装 路 径 并 勾 选 下 面 两 个 复 选 框 ， 如 图 1-4 所 示 。 


m 
a 


Install launcher for all users: 允许 所 有 登录 本 机 的 用 户 使 用 Python。 
Add Python 3.6to PATH: 将 Python 添加 到 系统 环境 变量 ， 方 便 以 后 调用 Python。 
如 果 不 勾 选 此 项 ， 将 来 使 用 Python 时 需要 填写 Python 的 全 路 径 。 


python 
windows 
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Install Python 3.6.3 (64-bit) 
Select Install Now to install Python with default settings. or choose 
Customize to enable or disable features. 


® Install Now 
C\Users\adminAppData\Loca\Programs\Python\Python36 


Ircludes IDLE, pip and documentation. 
Creates shortcuts and file associations 


æ Customize installation 
Choose location and features 


Install launcher for all users (recommended) 
IV] Add Python 3.6 to PATH 


图 1-4 


单 击 Customize installation ， 选 择 安装 路 径 以 及 安装 组 件 ， 如 图 1-5 所 示 。 


python 
windows 


Optional Features 


Documentation 
Installs the Python documentation file. 


M pip 


Installs pip, which can download and install other Python packages. 


td/tk and IDLE 


Installs tkinter and the IDLE development environment. 


Python test suite 
Installs the standard library test suite. 


py launcher V] for all users (requires elevation) 
Use Programs and Festures to remove the 'py launcher. 


Ce] 


图 1-5 


单 击 Next 按钮 ， 按 照 图 1-6 设置 ， 并 选择 Python 安装 路 径 。 


E Python 36.3 (64-bit) : 


python 
windows 


Advanced Options 

E Install for all users 

Associate files with Python (requires the py launcher) 
国 Create shortosts for installed apolications. 

Z] Add Python to environment variables 

Precompile standard library 

E Download debugging symbols 

El Download debug binaries (requires VS 2015 or later) 


Customize instal locaton 


[ovem | [ cms | 


DAProgram Files\Python36 


= 
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E Install 按钮 开始 安装 ， 如 图 1-7 所 示 。 
区 Python 3.6.3 (64-bit) Setup amn: —— im] 


J Setup Progress | 


Installing: 
Precompiling standard library 
L3 EI 


puthon 
windows [canei] 


图 1-7 


安装 结束 ， 如 图 1-8 所 示 
B» Python 3.6.3 (64-bit) Setup. -— zup — 


J Setup was successful 


Special thanks to Mark Hammond, without whose years of 
freely shared Windows expertise, Python for Windows would 


still be Python for DOS. 
(on? Start with the online tutorial and 


new in this release. 


python 
for 
windows [ose 


图 1-8 


打开 命令 行 工具 验证 Python 是 否 安装 成 功 ， 如 图 1-9 所 示 。 


Ifl CAWindows\system32\cmd.exe 


图 1-9 
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1.2.3 ”在 Mac OS 系统 中 搭建 Python 开发 环境 


登录 Python 官网 下 载 最 新 版 本 的 安装 包 。 
下 载 完成 ， 双 击 安装 文件 进行 安装 ， 如 图 1-10 所 示 。 


欢迎 使 用 "Python" 安 装 器 


This package wil! install Python 3.6.3 for Mac OS X 10.6 or later. 


: There are important changes in this release regarding network 
and trust certificates. Please see the ReadMe for more details. 


图 1-10 
安装 结束 ， 如 图 1-11 所 示 。 
oke w S Python" a 
安装 成 功 。 
安装 成 功 。 
软件 已 安装 


| X ) 


图 1-11 
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验证 Python， 可 以 使 用 如 下 命令 : 


$ python3 --version 
Python 3.6.4 


选择 Python 编辑 器 


工 欲 善 其 事 ， 必 先 利 其 器 。 一 款 优秀 的 开发 工具 可 以 极 大 地 提高 工作 效率 ， 
Python 语言 的 脚本 特性 ， 使 得 其 几乎 可 以 用 任何 工具 进行 开发 。 目 前 比较 流行 的 
Sublime Text, Vim, PyCharm, Eclipse with PyDev 等 ， 这 些 工具 各 有 优势 ， 


据 个 人 喜好 进行 选择 。 


由 于 本 书 所 有 示例 代码 均 基 于 Windows 3 


于 


发 工具 有 
发 人 员 可 以 根 


EF 台 ， 所 以 选择 Visual Studio Code 进行 代码 编 


Tjo Visual Studio Code 是 微软 近年 来 推出 的 一 款 轻 量 级 代码 编辑 器 ， 它 继承 了 Visual Studio 
的 很 多 优点 ， 如 语法 高 亮 、 可 定制 热 键 、 括 号 匹配 、 代 码 片段 收集 等 实用 功能 ， 同 时 又 提供 
了 对 Linux 平台 的 支持 ， 使 得 众多 Windows 平台 开发 人 员 可 以 轻松 地 转移 到 Linux ?| 
外 还 可 以 通过 安装 插件 的 方式 使 Visual Studio Code 对 不 同 语言 进行 支持 。 

Visual Studio Code 官方 下 载 地 址 为 https://code.visualstudio.com/Download。 


下 载 安装 ， 如 图 1-12 所 示 。 
接受 许可 协议 ， 如 图 1-13 所 示 。 


M EREE - Visual Studio C —| or ms 


Been Visual Studio Code 安装 向 


这 格 在 计算 机 上 安装 Marosoft Visual Studo Code « 
建议 关闭 所 有 其 他 应 用 程序 再 继续 。 
单 击 下 一 步 世 继续 ， 或 单 击 职 消 亿 届 出 安装 程序 。 


区 全 
LI. 


AA ewan veas CENE o ms 
许可 协议 x 
请 在 继续 操作 前 阅读 以 下 重要 信息 * 


VWERRULT TESI VI» 必须 接受 此 协议 条 才 才 可 继续 安装 * 


mares 

tzcmosorr VISUAL srUpi0 cove 

|eerafamkoo tms DR CEDXNOND) FEMER 
Du. 这 些 条 数 适 用 于 上 壕 坎 件 。 DESEE THREE ERA 
|&ws. E47 8&508254 YE. 

|cN t ri& KK. EAHEUTEM. 


LES AC] 
O 我 下 接受 协议 四 ) 


m) | 


Gizo) 


图 1-12 


选择 安装 路 径 ， 如 图 1-14 所 示 。 
选择 开始 菜单 ， 如 图 1-15 所 示 。 


图 1-13 


根据 个 人 喜好 选择 其 他 设置 ， 如 图 1-16 所 示 。 


准备 就 绪 ， 如 图 1-17 所 示 。 
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MN ERER -Visual Sudio cod = i tcm 


er EE 
选择 目标 位 置 x 
| 应 将 Visual Studio Code 安装 到 那里 ? | 


REIHE SPEC 
安装 程序 应 将 程序 的 快捷 方式 放置 到 哪里 ? 


bh 安装 程序 会 将 Visual Studo Code FART XR + 
Gd PETS IRSE HR. PER 


uL 安装 程序 将 在 以 下 开始 荣 单 文件 夫 中 创建 访 程 序 的 快捷 方式 。 
若 要 继续 ， 单 击 下 一 步 。 如果 想 选择 其 他 文件 夫 ， 单 击 浏览 "。 


D:\Program FlesWiaosoft VS Code ETA E cm 
需要 至 少 212.8 MB ARRERA. 回 不 B 键 开始 荣 单 文件 夫 O) 
| (sz-sm r-90] (RA | 
图 1-14 1-15 


M] ERF - Visual Studio boa 


I RRF - Visual Sudio cod Dd t. 


选择 其 他 任务 
| 应 执行 哪些 其 他 任务 ? 


x) 


安装 准备 就 绪 
安装 程序 现 已 准备 好 在 计算 机 上 安装 Vaual Studio Code。 


gem Visual Studio Code BR SPRER RATNE., ESSE 


RERI: 

Gi AE MSS) 

其 他 : 

E 将 通过 Code 打开 操作 添加 到 Windows 资源 管理 器 文件 上 下 文采 单 
E 将 通过 Code IFEHEMNI Windows 资源 管理 品目 录 上 下 文 菜单 
将 Code 注册 为 受 支 持 的 文件 类 型 6 所 可 器 

添加 到 PATH (重启 后 生效 ) 


单 击 支 装 亿 继续 安装 ， 如 想 查看 或 更 改 任何 设置 则 单 击 返回 
目标 位 置 : n 
D: Program Fles Microsoft VS Code 


THAN SEHR: 
Visual Studo Code 


图 1-16 
等 待 安 装 结束 ， 如 图 1-18 所 示 。 
安装 结束 ， 如 图 1-19 所 示 。 


M 安装 是 序 - Visual Studio: 


正在 安装 
安装 程序 正在 计算 机 上 安装 Vsual Studio Code， 请 稍 等 * 


ERER... 
D:\Program Files\Microsoft VS Code lapi-ms-win-crt-tme-1-1-0.dl. 


图 1-17 


X) EREE - Visual Studio Code = 


完成 Visual Studio Code 安装 向 导 

} 完 Visual Studio Code « jii: 
RCRHUVGREGEAERR 
启动 veual Studio Code 


图 1-18 


图 1-19 
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首次 打开 VS Code， 如 图 1-20 所 示 。 


praem 


Visual Studio Code 


图 1-20 


装 ， 此 时 提示 栏 出 现 安装 


对 Python HJ ZFF, TE HENE 


开始 之 前 先 安装 
确认 ， 如 图 1-21 所 示 


图 1-21 
单 击 “确定 ”按钮 开始 安装 
安装 结束 ， 单 击 左 侧 导航 栏 中 的 “扩展 ”按钮 ， 查 看 已 安装 插件 ， 如 图 1-22 所 示 


Python 


图 1-22 
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lm 


创建 一 个 Python X fF, JH VS Code 打开 该 文件 所 属 文件 夹 ， 单 击 “调试 ”菜单 ， 在 该 
文件 夹 下 会 自动 生成 一 个 .vscode 文件 夹 ， 其 中 包括 一 个 launch.json 文件 ， 该 文件 记录 了 
Python 相关 的 配置 信息 ， 如 图 1-23 所 示 。 


LVS codepy X 


004003 行 1, 列 1 S4 UTF-8 CRLF Python 四 


图 1-23 


到 目前 为 止 ，Python 开发 环境 已 经 配置 完成 


EE Helo World 程序 


前 面 我 们 已 经 开发 了 第 一 个 Python 脚本 ， 本 节 通 过 开发 一 个 Hello Word 程序 简单 讲解 
Python 开发 的 注意 事项 


1.4.1 Linux 系统 的 支持 


由 于 Python 是 一 门 跨 平台 的 编程 语言 ， 我 们 所 开发 的 程序 最 终 很 可 能 会 被 部 署 到 Linux 
系统 上 ， 所 以 在 开发 过 程 中 一 定 要 考虑 对 Linux 的 支持 。 在 Python 脚本 的 首 行 需要 添加 
Python 解释 器 。 该 解释 器 在 Windows 系统 中 不 会 起 任何 作用 ,但 是 在 Linux 系统 中 ， 执 行 
Python 脚本 的 时 候 会 调用 该 解释 器 执行 脚本 。 解 释 器 代码 如 下 : 


$!/usr/bin/python 或 者 #!/usr/bin/env python 
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加 


#l/usr/bin/python 是 解释 器 的 绝对 路 径 ， 当 Python 没有 安装 在 该 路 径 时 解释 器 失效 。 
#l/usr/bin/env python 通过 系统 路 径 自动 查找 Python 解释 器 ， 因 此 需要 保证 Python 的 安装 


14.2 非 英文 字符 的 支持 


所 示 。 


对 于 非 英语 区 的 开发 人 员 来 说 ， 字 符 集 是 一 个 重要 问题 ， 在 代码 中 紧 跟 Python 解释 器 


要 添加 对 其 他 语言 的 支持 ， 下 面 是 对 utf-8 字符 集 (包含 简体 中 文 ) 的 支持 : 


* -*- coding: UTF-8 -*- 或 者 #coding=utf-8 


以 上 讲解 了 Python 脚本 的 注意 事项 ， 下 面 开 始 编写 “ Hello Word!” fF, nd 1-24 


24} Hellowordpy - Python - Visual Studio Code - er 


RAO IRSE) EEV 转 到 (G) WEO) M 帮助 (H) 


HelloWord.py X 


Python 3.6 (64-bit) 行 4. 列 21 A UTF-8 CRLF Python 全 
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EX] 变量 的 命名 
变量 (variable) 在 Python 中 代表 某 一 个 对 象 的 名 字 ， 如 : 


>% x23 


那么 x 就 是 一 个 变量 ， 它 所 对 应 的 值 就 是 3， 这 样 的 操作 叫 作 赋 值 。 


l E Python 中 变量 名 可 以 包含 字母 、 数 字 和 下 画 线 (_)。 变 量 名 不 能 以 数字 开头 ， 所 以 
' name, age, timel 都 是 合法 的 Python 变量 ,但 是 llength, max%number 都 是 非法 变量 。 


A String 类 型 S 


1. 定义 
String 类 型 就 是 字符 串 ， 用 来 存储 一 段 文 字 。Python 中 将 一 段 文字 放 在 单 引 号 、 双 引号 
或 者 三 引号 中 即 表示 一 个 字符 串 ， 如 图 2-1 所 示 。 


2. 特殊 字符 的 处 理 

有 时 在 字符 串 中 会 出 现 单 引 号 或 者 双 引 号 ， 此 时 我 们 需要 对 其 进行 处 理 ， 处 理 方式 有 以 
下 两 种 。 

方法 一 : 对 字符 串 中 出 现 的 特殊 字符 进行 转 义 ， 就 是 告诉 Python 解释 器 当前 的 字符 均 为 
普通 字符 ， 不 做 特殊 处 理 ，Python 中 的 转 义 符 为 反 斜 线 O), WA 2-2 所 示 。 

输出 结果 : 


>>> Let's learn Python 
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图 2-1 
方法 二 : 通过 引号 的 内 套 解决 字符 串 中 的 引号 问题 ， 如 图 2-3 所 示 。 
输出 结果 : 


>>> Let's learn Python 
3. 访问 字符 串 中 的 字符 


在 Python 中 字符 串 存 储 在 一 个 以 0 开始、 使 用 整数 索引 的 字符 串 序 列 中 ， 所 以 要 取得 
某 一 个 字符 可 以 使 用 索引 值 ， 如 图 2-4 所 示 


learn = 


print(learn 


print( 
print(learn[5 
图 2-3 
分 别 输 出 
>>> L 
EP qu 
>>> [] 


4. 字符 串 运 算 
拼接 字符 串 ， 如 图 2-5 所 示 


>>> Helloword 
重复 输出 字符 串 ， 如 图 2-6 所 示 。 


hello = 


word = 


print(hello + word 


图 2-6 


输出 : 


>>> HelloHelloHello 


5. 格式 化 字符 串 
格式 化 输出 字符 串 。 
输出 : 


>>> Hello word! 
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通常 用 来 将 一 个 值 插入 到 字符 串 中 ， 如 图 2-7 所 示 。 


Python 不 仅 可 以 将 一 个 字符 串 插入 到 另 一 个 字符 串 中 ， 还 可 以 通过 格式 化 符号 进行 更 复 


杂 的 操作 ， 如 表 2-1 所 示 


表 2-1 

符 号 作 A 
%c 格式 化 字符 及 其 ASCI 码 
%s 格式 化 字符 串 
%d 格式 化 整数 
%u 格式 化 无 符号 整数 
960 格式 化 无 符号 八进制 数 
%x KREE 进 制 数 
%X 格式 化 无 符号 十 六 进 第 
%f 
%e 
%E 作用 同 %e, E KĘ 
%g Afe 的 简 
%G APAE 的 简写 


Python 中 str 对 象 专 


门 提供 了 一 个 字符 串 格式 化 方法 ， 如 图 2-8 所 示 


图 2-7 图 2-8 
输出 
>>> Hello word! 
6. 字符 串 切片 
要 提取 字符 串 中 的 部 分 值 ， 可 以 使 用 切片 运算 符 s[ij]。 这 样 会 提取 字符 串 s 中 从 索引 ii 


开始 一 直到 索引 j 的 所 有 


字符 k, 的 范围 是 i mk: 如 果 省 略 i1， 则 从 0 开始; 如果 省 略 j， 


则 一 直 提 取 到 字符 串 结尾 。 三 种 情况 如 图 2-9 所 示 。 


-51m 
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输出 : 


>>> Let 
>>> learn Python 
>>> 19 


7. Unicode 字符 串 


>>> 我 爱 Python 


8. Python 字符 串 内 建 函 数 
由 于 字符 串 是 一 个 非常 重要 的 对 象 ，Python 针对 字符 串 增加 了 很 多 内 建 函 数 。String 对 
象 的 定义 可 以 在 Lib/string.py 中 找到 


EE] Number 类 型 


Python 的 Number 类 型 是 用 来 存储 数值 的 。 不 像 其 他 语言 按照 数据 类 型 细 分 为 整数 、 浮 
点 数 等 不 同 对 象 ，Python 中 只 要 将 整数 赋值 给 变量 ， 那 么 变量 就 是 整 型 ， 如 果 将 浮 点 数 赋值 
给 变量 ， 那 么 变量 就 是 浮 点 型 。 

Python 支持 整数 、 长 整数 、 浮 点 数 和 复数 等 常用 数值 类 型 。 

Python 的 数值 类 型 是 不 可 以 改变 的 ， 如 果 通 过 运算 或 重新 赋值 来 改变 变量 值 ， 将 会 重新 
分 配 内 存 空间 。 

不 同类 型 的 两 个 数值 变量 进行 计算 ， 生 成 的 新 变量 将 按照 精度 高 的 类 型 划分 内 存 。 如 一 
个 整数 与 浮 点 数 运算 生成 的 变量 也 是 浮 点 数 ， 如 图 2-11 所 示 。 

不 同 数值 类 型 之 间 是 可 以 转换 的 ,但 是 在 转换 前 一 定 要 确保 转换 后 的 数据 类 型 精度 大 于 
等 于 转换 前 的 数据 类 型 精度 ， 如 可 以 将 整数 转换 为 浮 点 数 ， 但 是 如 果 将 浮 点 数 转换 为 整数 就 
可 能 出 错 。 

如 图 2-12 所 示 的 示例 2， 将 5.5 转换 为 整数 时 小 数 点 后 数据 丢失 。 
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图 2-11 图 2-12 


常用 的 数值 类 型 转换 方式 如 图 2-13 所 示 
Python 通过 math 包 提供 量 了 丰富 的 数学 函数 ， 使 用 方法 如 图 2-14 所 示 


图 2-13 图 2-14 


EI List 类 型 


列表 (List) 是 多 个 元 素 的 集合 ， 每 个 元 素 都 会 被 分 配 一 个 以 0 开始 的 索引 ， 第 一 个 元 素 
的 索引 是 0， 第 二 个 元 素 的 索引 是 1， 以 此 类 推 ， 第 mn 个 元 素 的 索引 就 是 n-1。 列 表 中 的 元 素 
可 以 有 不 同 的 类 型 ， 同 时 列表 是 可 以 修改 的 。 

列表 的 定义 如 图 2-15 所 示 。 
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2.4.1 列表 的 基本 操作 


与 字符 串 一 样 ， 可 以 通过 索引 访问 列表 中 的 元 素 ， 同 时 列表 也 支持 切片 操作 ， 如 图 2-16 
所 示 。 


图 2-16 


2.4.2 ”修改 列表 


由 于 列表 是 可 以 修改 的 ， 所 以 可 以 更 改 或 者 删除 任意 列表 元 素 ， 如 图 2-17 Bras 


图 2-17 


2.4.3 ”列表 方法 
由 于 列表 是 一 个 非常 重要 的 对 象 ， 所 以 Python 内 置 很 多 常用 的 列表 方法 。 


1. append 
append 方 法 用 于 在 列表 未 尾 添加 新 元 素 ， 如 图 2-18 所 示 。 


2. count 
count 方法 用 于 统计 列表 中 某 个 元 素 出 现 的 次 数 ， 如 图 2-19 所 示 。 
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"Python", "Vou", "Loue", "Python", "Too"] 


3. extend 

extend 方法 用 于 在 列表 未 尾 追 加 另 一 个 列表 ， 而 当前 列表 内 存 地 址 不 变 ， 如 图 2-20 
所 示 

4. index 

查找 某 一 个 值 第 一 次 出 现在 列表 中 的 索引 位 置 ， 如 果 该 值 在 列表 中 不 存在 则 抛 出 异常 ， 
如 图 2-21 所 示 


sti [1, 
ti.index 


st): 
nodule? 


图 2-20 


5. insert 

insert 用 于 向 列表 中 插入 一 个 值 ， 如 图 2-22 所 示 

6. pop 

pop 用 于 删除 列表 中 的 一 个 值 ， 默 认 删 除 最 后 一 个 值 ， 并 返回 该 元 素 的 值 ， 如 图 2-23 所 示 


listi = [1 
listi. popl 


listi.pop(? 


图 2-23 


7. remove 

删除 列表 中 第 一 次 出 现 的 某 个 值 ， 如 图 2-24 所 示 。 
8. reverse 

翻转 列表 中 的 元 素 ， 如 图 2-25 所 示 。 
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9. sort 
对 列表 排序 ， 此 时 列表 内 的 元 素 顺序 发 生 改 变 ， 列表 本 身 内 存 地 址 不 变 ， 如 图 2-26 
所 示 


可 以 通过 y=x[:] 的 方式 快速 复制 一 个 列表 。 
可 以 通过 y= sorted(x) 的 方式 获得 已 排 好 序 的 列表 x 的 副本 。 


BA Tupe 类 型 


Tuple 是 Python 特有 的 一 个 数据 类 型 ， 中 文 翻译 为 元 组 。 元 组 与 列表 一 样 ， 也 是 一 个 序 
列 ， 不 同 之 处 在 于 列表 可 以 修改 而 元 组 不 可 以 

创建 元 组 的 语法 非常 简单 ， 只 要 用 逗号 分 隔 一 些 值 即 可 ， 如 图 2-27 所 示 

但 是 大 部 分 时 候 都 是 通过 圆 括号 来 声明 元 组 的 ， 图 2-28 展示 了 几 种 常用 的 元 组 声明 方式 


图 2-27 图 2-28 


2.5.1 tuple 函数 
tuple 函数 可 以 将 一 个 序列 转换 为 元 组 ， 如 图 2-29 所 示 。 


2.5.2 ”访问 元 组 


与 其 他 列表 一 样 ， 可 以 通过 下 标 来 查找 元 组 中 的 元 素 ， 如 图 2-30 所 示 。 
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Dictionary 类 型 


字典 ( Dictionary) 是 一 种 数据 结构 ， 它 像 列表 一 样 存储 多 个 元 素 ， 每 个 元 素 都 包含 一 个 
键 (Key) 和 值 ( Value)， 其 中 键 是 不 能 重复 的 ， 而 值 是 可 以 重复 的 。 字 典 中 的 键 - 值 对 没有 
特定 的 存储 顺序 ， 读 者 可 以 通过 键 来 快速 得 到 对 应 的 值 ， 这 与 通过 书籍 目录 来 快速 查找 章节 
一 样 。 

Python 中 的 字典 使 用 大 括号 “ {} ”表示 ， 其 中 的 键 - 值 对 使 用 冒号 分 隔 ， 键 值 对 之 间 使 
用 逗号 分 隔 ， 例 如 : 


2.6.1 访问 字典 元 素 
刚才 讲 到 字典 中 的 键 类 似 于 数据 的 目录 ， 所 以 可 以 通过 键 来 查找 元 素 值 ， 方 法 如 下 : 


如 果 访 问 的 键 不 存在 ， 会 输出 错误 : 


2.6.2 ”检查 字典 中 是 否 存在 某 个 键 


2.6.3 ”修改 字典 


1. 添加 键 - 值 对 
可 以 通过 访问 字典 值 的 方式 添加 键 - 值 对 ， 虽 然 字 典 中 并 不 存在 该 键 ， 但 是 字典 会 自动 
增加 一 个 键 - 值 对 ， 如 修改 前 面 例子 如 下 : 


| 22 Django 2.0 入 门 与 实践 


2. 删除 一 个 键 - 值 对 


3， 修 改 一 个 键 关联 的 值 


2.64 字典 方法 


1. clear 


用 于 清空 字典 中 的 所 有 项 ， 该 方法 不 返回 任何 内 容 : 


2. copy 

在 讲解 这 个 方法 之 前 ， 先 了 解 两 个 概念 : 浅 拷贝 和 深 拷贝 。 

对 于 可 变 对 象 如 列表 、 字 典 ， 直 接 赋值 时 只 会 将 一 个 对 象 的 引用 传递 给 另 一 个 对 象 ， 此 
时 修改 其 中 一 个 对 象 就 会 改变 男 一 个 对 象 ， 如 : 


大 多 数 情况 下 ， 一 个 可 变 对 象 内 还 可 以 嵌 套 其 他 可 变 对 象 ， 此 时 浅 拷贝 只 会 拷贝 顶级 对 
象 ， 而 对 于 髋 套 的 对 象 ， 只 会 拷贝 它 的 引用 ， 所 以 修改 顶级 对 象 不 会 影响 另 一 个 对 象 , 但 是 
如 果 修 改 骨 套 的 对 象 就 会 影响 两 个 对 象 了 : 
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由 此 可 见 ， 在 浅 拷贝 的 情况 下 修改 顶级 元 素 不 会 影响 另 一 个 对 象 ， 但 是 修改 内 部 可 变 
元 素 时 就 会 同时 修改 原始 对 象 与 新 对 象 了 ， 为 了 解决 这 个 问题 字典 提供 了 一 个 深 拷贝 方法 。 
深 拷贝 就 是 将 顶级 对 象 以 及 子 对 象 的 值 同时 拷贝 给 新 对 象 ， 此 时 修改 任何 一 个 都 不 会 影响 
努 一 个 5 

由 于 字典 也 是 可 变 对 象 ， 所 以 copy 方法 也 遵循 以 上 原则 。 

如 果 想 对 字典 进行 深 拷贝 操作 ， 需 要 引用 copy 包 中 的 deepeopy 方法 : 


3. fromkeys 


使 用 给 定 的 一 些 键 创建 一 个 新 的 字典 ， 所 有 键 对 象 的 值 为 None。 


如 果 不 想 用 None 来 作为 默认 值 ， 也 可 以 给 定 其 他 值 : 


4. get 
访问 一 个 字典 项 ， 如 果 试 图 访问 的 字典 项 不 存在 时 返回 None， 也 可 以 返回 其 他 值 ， 对 
字典 本 身 没有 任何 影响 : 
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5. items 


items 会 将 字典 中 的 所 有 项 以 列表 的 方式 返回 ， 返 回 时 没有 特殊 顺序 : 


6. keys 
将 字典 中 的 键 以 列表 的 形式 返回 : 


7. values 


将 字典 中 的 值 以 列表 的 形式 返回 : 


8. pop 
删除 一 个 键 - 值 对 并 返回 对 应 的 值 : 


9. popitem 
随机 删除 一 个 字典 项 并 返回 : 
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10. setdefault 
与 get 方 法 基本 一 致 ， 唯 一 的 区 别 就 是 当 键 不 存在 时 ，setdefault 方法 会 创建 一 个 新 字典 项 


11. update 
根据 一 个 字典 项 更 新 字典 ， 如 果 字 典 项 在 原始 字典 中 不 存在 则 在 字典 中 添加 该 项 : 
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就 像 数 学 中 的 加 减 乘除 运算 符 一 样 ，Python 的 变量 与 变量 之 间 也 可 以 进行 运算 ,例如 
243 是 一 个 Python 表达 式 ， 而 “+” 就 是 运算 符 。 
Python 中 的 运算 符 大 致 可 以 分 为 以 下 几 类 : 
O 算术 运算 符 ; 
O 比较 运算 符 ; 
Q 赋值 运算 符 ; 
口 逻辑 运算 符 ; 
Q 成 员 运 算 符 ; 
口 身份 运算 符 ; 
口 位 运算 符 。 


EXPB 算术 运算 符 


算术 运算 符 就 是 进行 数学 运算 的 操作 符 ，Python 中 的 算术 运算 符 如 表 3-1 所 示 。 
表 3-1 


例 


3l 


2+3 输出 结果 为 5 

5-2 输出 结果 为 3 

2*3 输出 结果 为 6 

6/2 输出 结果 为 3 

5%3 输出 结果 为 2 

右 侧 操作 数 3 小 于 等 于 5 的 倍数 是 3，5-3 等 于 2 
7%3 输出 结果 为 1 

右 侧 操作 数 3 小 于 等 于 7 的 倍数 是 6，7-6 等 于 1 
9953 输出 结果 为 0 

右 侧 操作 数 3 小 于 等 于 9 的 倍数 是 9，9-9 等 于 0 


模 运 算 ， 返 回 除法 的 余数 ， 即 左 侧 操作 数 
96 减 去 右 侧 操作 数 小 于 等 于 左 侧 操作 数 的 倍 
数 所 得 的 余数 
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续 表 


例 


3l 


2**3 输出 结果 为 8 
除法 运算 9/4 的 输出 结果 为 2.25 
整除 运算 9//4 的 输出 结果 为 2 


整除 运算 ， 返 回 商 的 整数 部 分 


EH utes 
数学 中 两 个 数 有 大 小 之 分 ，Python 变量 之 间 也 可 以 进行 大 小 比较 ， 比 较 运 算 符 如 表 3-2 
所 示 。 


表 3-2 
比较 运算 符 描 i - 9l 
返回 True 
一 等 于 运算 符 
地 于 运算 符 返回 False 
eS 2122 返回 False 
I= 等 于 运算 符 
i 人 21-3 返回 True 
3>2 返回 True 
> 大 于 运算 符 2>3 返回 False 
3>3 返回 False 
2<3 返回 True 
< 小 于 运算 符 3<2 返回 False 


3<3 返回 False 

32-2 返回 True 
>a 大 于 等 于 运算 符 2>=3 返回 False 
32-3 返回 True 
2«-3 返回 True 
z= 小 于 等 于 运算 符 3<=2 返回 False 


3<=3 返回 True. 
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赋值 运算 符 


赋值 运算 就 是 将 右 侧 的 表达 式 或 者 数值 赋值 给 左 侧 变量 ， 如 表 3-3 所 示 。 


t 


将 两 例 
则 操作 数 


将 两 侧 
则 操作 数 


将 两 侧 
操作 数 


将 两 侧 
则 操作 数 


EZH 


操作 数 村 


表 3-3 


操作 数 是 可 变 类 型 则 将 指针 传递 给 左 侧 


i 将 结果 赋值 给 左 


[将 结果 赋值 给 左 


将 结果 赋值 给 左 


操作 数 相 除 ， 


将 结果 赋值 给 左 


A=2+3 
将 2+3 的 结果 5 赋值 给 A 


Listl=[1.2.3] 
List2=Listl 
赋值 结束 后 ， 
A=2 

B=3 

A+=B 

赋值 结束 后 ， 
A-5 

B-3 

A--B 

赋值 结束 后 ， 
A=5 

B=3 

A*=B 
赋值 结束 后 ， 
A=6 

B=3 

A/=B 

赋值 结束 后 ， 


Listl 与 List2 指向 同一 内 存 地 址 


A 等 于 15 


A 等 于 2 


先 求 模 ， 再 将 结果 赋值 给 左 侧 操作 数 


先进 行军 运算 ，, 再 将 结果 赋值 给 左 侧 操 


作 数 


先进 行 整除 运算 ， 再 将 结果 赋值 给 左 侧 操 


作 数 


A-7 
B-3 
A%=B 
赋值 结束 后 ， 
A=2 

B=3 

A**-B 
赋值 结束 后 ， 


A 等 于 1 
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3 ups TERT 


Python 支持 的 逻辑 运算 符 如 表 3-4 所 示 。 
表 3-4 


逻辑 运算 符 d x 
A-True 
B-True 
A and B 返回 True 


逻辑 “与 
and 只 有 当 and 两 侧 变量 都 为 真 表达 式 才 返 回 
True, WNE Pl False 


A=True 
B=False 
A and B j& [1] False 


A-False 

B-False 

A and B 返回 False 
A-True 

B-True 

A or B 返回 True 


逻辑 
or 只 要 or 运算 符 两 侧 任意 一 个 变量 为 Tme， 
就 返回 True， 和 否则 返回 False 


A-True 
B-False 
A or B 返回 True 


A-False 
B-False 
A or B 返回 False 
如 果 A-True 
逻辑 “ 非 ” 则 notA 返回 False 
not 取 反 操作 ， 如 果 变量 为 Tue， 则 返回 False, 
如 果 变 量 为 False， 则 返回 True 


如 果 A=False 
则 not A 返回 True 


3.5 成 员 运算 符 


成 员 运 算 符 用 来 判断 对 象 是 否 属于 一 个 集合 ， 集 合 可 以 是 字符 串 、 列 表 、 元 组 等 ， 
Python 支持 的 成 员 运 算 符 如 表 3-5 所 示 。 


表 3-5 


A=[1,2.3] 
1inA 返 回 True 
4 让 a 返 回 False 


如 果 指 定 值 出 现在 序列 
则 返回 False 


ph 则 返回 True, d 
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续 表 
Ho x 示 A 
A=[1.2.3] 
1 not in A 返回 False 
4 not in a 返回 True 


与 也 运算 符 相 反 ， 如 果 指 定 值 出 现在 序 
列 中 则 返回 False， 否 则 返回 True 


EG 身份 运算 符 


身份 运算 符 用 来 比较 两 个 对 象 的 内 存 地 址 是 否 相 同 ， 如 表 3-6 所 示 。 


表 3-6 
身份 运算 符 do xk m H 
A={} 
ETES: 在 3j B-0 
a 如 果 两 个 对 象 的 内 存 地 址 相同 则 返回 ILIA 
is EIS Ais B 返回 False 
Tme， 否 则 返回 False 
B=A 
Ais B 返回 True 
A={} 
如 果 两 个 对 象 的 内 存 地 址 不 相同 则 返回 | 2 人 
is not A is not B 返回 True 


True， 和 否则 返回 False B-A 


A is not B 返回 False 


计算 机 中 的 所 有 对 象 都 是 以 二 进 制 形式 保存 的 ， 所 以 Python 支持 将 两 个 对 象 按 位 进行 


如 变量 a 的 二 进 制 格式 为 0011 0101， 变 量 b 的 二 进 制 格式 为 0101 1100， 如 表 3-7 所 示 ， 
表 3-7 


对 两 个 变量 进行 按 位 与 运算 a&b=0001 0100 
对 两 个 变量 进行 按 位 或 运算 alb=0111 1101 
对 两 个 变量 进行 按 位 异 或 运算 a^b=0110 1001 
按 位 取 反 ~a=1100 1010 


EXJ 运算 符 的 优先 级 


像 数学 运算 中 的 加 减 乘除 有 不 同 的 优先 级 一 样 ，Python 的 运算 符 也 有 不 同 的 优先 级 ， 表 
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3-8 按照 优先 级 从 高 到 低 的 顺序 列 出 了 Python 中 的 所 有 运算 符 。 


表 3-8 

运 算 符 描 述 
++ 指数 ( 最 高 优先 级 ) 
~+- 按 位 翻转 ,一 元 加 号 和 减 号 (最 后 两 个 的 方法 名 为 +@ 和 -@) 
*/%// 乘 ， 除 ， 取 模 和 取 整 除 
+- 加 法 ， 减 法 
>> << 右 移 ， 左 移 运算 符 
& 
| 
<= <> > 一 
= 二!= 
=%= 广 /三 一 +=*=**= | 赋值 运算 符 
is, is not 身份 运算 符 
in, not in 成 员 运 算 符 


not or and 逻辑 运算 符 


第 4 章 
流程 控制 


前 面 学 习 了 Python 的 基本 变量 类 型 以 及 了 Python 的 运算 符 ， 在 学 习 过 程 中 使 用 交互 式 窗 
口 演 示 了 如 何 使 用 Python， 读 者 可 能 会 发 现 前 面 的 Python 代码 过 于 简单 ， 代 码 结构 不 清晰 ， 
本 章 将 会 介绍 Python 代码 的 流程 控制 语句 


EE tih 


在 介绍 Python 的 流程 控制 语句 之 前 ， 先 介绍 一 个 概念 : 代码 块 。 代 码 块 不 是 一 种 特殊 的 
语句 ， 它 是 一 系列 功能 相似 的 代码 集合 ， 在 编写 代码 时 通过 一 定 的 编程 规范 将 一 组 代码 编 为 
统一 执行 。 在 Java 和 C# 语言 中 使 用 大 括号 “{}” 对 代码 进行 归 类 ， 大 括号 中 的 代码 
5 一 个 代码 块 。Python 中 使 用 缩 进 的 方式 对 代码 进行 分 组 ， 缩 进 一 样 的 
e. -个 代码 块 ， 推 荐 使 用 4 个 空格 作为 一 个 缩 进 单位 
图 4-1 的 伪 代 码 展示 了 Python 的 缩 进 方式 
上 面 伪 代 码 中 代码 块 1 包含 3 行 代码 ， 代 码 块 2 包含 2 行 代码 ， 其 
中 Line 5 又 包含 了 2 行 代码 。 每 个 代码 块 都 是 以 冒号 ( : ) 开始 的 。 
Python 代码 不 需要 明确 的 结束 标记 ， 但 是 编程 人 员 为 了 使 代码 结构 
清晰 ， 可 以 选择 在 代码 块 结束 位 置 添加 一 个 pass 语句 表示 当前 代码 块 执 
行 结束 


PA 条 件 判断 语句 


前 面 章 节 中 的 示例 代码 都 是 一 行 一 行 按 顺 序 执行 的 ， 但 是 现实 中 代码 往往 需要 进行 一 定 
的 判断 来 选择 是 否 执 行 ， 条 件 判 断 语句 就 可 以 完成 这 样 的 功能 。 
以 学 生 考试 成 绩 为 例 ，60 分 以 上 为 及 格 ，60 分 以 下 为 不 及 格 , 编写 代码 如 下 : 


$!/usr/bin/python 
E -s-uccodanqzNUEPR He 


mm suse ss NEN 


以 上 代码 执行 结束 ， 输 出 “及 格 ”， 而 不 会 输出 “不 及 格 ”， 由 此 可 见 代码 只 执行 了 “让 
score >= 60:” 所 包含 的 代码 块 ， 而 没有 执行 “else:” 所 包含 的 代码 块 。 如 果 将 score 修改 为 
50， 则 会 输出 “不 及 格 ”。 

由 此 可 见 ， 条 件 判断 语句 是 根据 布尔 表达 式 的 值 选 择 代码 块 来 执行 的 。 下 面 的 值 在 条 件 
判断 中 都 会 被 认为 是 假 (false): 


除 以 上 类 型 外 ， 其 他 类 型 都 会 被 认为 是 真 (true) 而 执行 相应 的 代码 块 。 

现实 中 条 件 判 断 往 往 会 更 复杂 ， 会 出 现 多 种 情况 ， 此 时 可 以 使 用 elif 关键 字 来 区 分 更 
多 情况 。 仍 以 考试 成 绩 为 例 ，90 分 以 上 为 优秀 ，80 ~ 89 分 为 良好 ，70 ~ 79 分 为 中 等 ， 
60 ~ 69 分 为 及 格 ，60 分 以 下 为 不 及 格 。 编 写 代 码 如 下 : 


此 时 同样 成 绩 为 70 分 会 输出 “中 等 ”。 
在 条 件 判断 语句 中 不 仅 可 以 使 用 算术 运算 符 ， 其 他 任何 布尔 运算 都 可 以 ， 如 使 用 成 员 表 
达 式 判断 今天 是 否 是 工作 日 : 
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输出 结果 : 今天 是 工作 日 。 


循环 语句 


顾名思义 ,循环 语句 就 是 将 一 个 代码 块 执行 多 次 的 语法 结构 。 如 果 想 要 打印 一 个 数组 ， 
可 以 遍历 数组 中 的 每 一 个 元 素 ， 然 后 打印 出 来 ， 当 遍历 完整 个 数组 时 循环 结束 。 也 可 以 使 用 
break 关键 字 在 循环 过 程 中 退出 循环 ， 或 者 使 用 continue 关键 字 跳 过 其 中 的 一 次 循环 。 


4.3.1. for 循环 语句 


for 循环 的 语法 结构 如 下 : 


在 这 个 例子 中 ，s 是 一 个 包含 多 个 元 素 的 序列 ， 如 字符 串 、 数 组 等 。 每 一 次 遍历 都 会 从 s 
中 提取 一 个 元 素 并 赋值 给 变量 x， 同 时 执行 代码 块 。 
例如 ， 遍 历数 组 并 将 数组 的 每 一 个 元 素 乘 以 10 打印 出 来 : 


使 用 continue 语句 可 以 跳 过 部 分 循环 ， 如 果 只 希望 打印 奇数 数字 ， 可 以 嵌 套 让 语句 ， 代 
码 如 下 : 
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与 continue 不 同 的 是 ， 使 用 break 语句 可 以 跳出 整个 循环 ， 后 面 所 有 的 变量 都 不 会 继续 
执行 ， 例 如 ， 只 想 打印 出 小 于 等 于 3 的 数字 : 


输出 结果 : 


4.3.2 while 循环 语句 
while 循环 的 语法 结构 如 下 : 


while 循环 会 根据 while 判断 条 件 决 定 是 否 执行 内 部 代码 ， 只 有 当 判 断 条 件 为 真 时 才能 执 
行 ， 否 则 循环 结束 。while 循环 也 可 以 使 用 continue 和 break 语句 来 控制 循环 执行 。 以 while 
为 例 完成 上 面 两 个 示例 : 
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输出 奇数 : 


输出 结果 : 


输出 小 于 等 于 3 的 数字 : 


RAE 


4.4.1 lterable 


上 一 节 介 绍 了 forim, AARTEEN, fk Python PHREN AR RART ETTE 
ARAI, (PERDE AEREE E : 
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错误 信息 表明 整数 对 象 是 不 可 以 进行 迭代 操作 的 。 如 何 判 断 一 个 对 象 是 否 可 以 进行 迭代 
呢 ? 可 以 使 用 collections 模块 的 Iterable 类 型 来 判断 : 


4.4.2 enumerate 


enumerate 函数 可 以 将 一 个 序列 转换 为 索引 - 元 素 对 ,方便 在 操作 序列 时 使 用 元 素 的 索 
引 。 下 面 改 进 for 循环 ， 使 用 enumerate 函数 在 循环 中 同时 和 迭代 索引 和 元 素 本 身 : 


44.3 列表 推导 式 


列表 推导 式 〈list comprehension) 是 利用 其 他 列表 创建 新 列表 的 一 种 方式 。 它 的 工作 方 
式 类 似 于 for 循环 ， 例 如 : 
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上 面 列表 推导 式 中 的 “forx in range(10)” 相 当 于 一 个 for 循环 ，range0 函数 用 来 创建 一 
个 新 的 列表 ， 在 每 次 循环 的 时 候 将 循环 变量 x 赋值 给 表达 式 x*x, x x 相当 于 for 循环 的 代码 
块 ， 最 后 根据 x*x 生成 新 列表 。 

我 们 知道 for 循环 是 可 以 符 套 让 条 件 判 断 语句 的 ， 在 列表 推导 式 中 一 样 可 以 ， 例 如 ， 生 
成 一 个 奇数 数组 : 


当然 列表 推导 式 中 的 for 循环 也 是 可 以 榜 套 的 ， 例 如 : 


Ti Rec —————— 
/ 意 s, 


虽然 列表 推导 式 非 常 灵活 ， 但 是 为 了 保证 代码 的 易 读 性 ， 建 议 在 列表 推导 式 中 不 要 训 ， 
套 过 多 层次 ， 推 荐 最 多 两 层 。 
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前 面 章节 介绍 了 Python 的 基本 概念 ， 在 演示 代码 中 实现 了 一 些 简单 功能 ， 如 列表 循环 
遍历 等 ， 细 心 的 读者 可 能 会 发 现 之 前 的 Python 代码 都 是 逐 行 执行 的 ， 也 就 是 说 ， 后 面 的 代 
码 只 能 使 用 前 面 已 经 声明 的 变量 ， 而 对 于 循环 遍历 等 复杂 操作 ， 执 行 一 次 之 后 ， 如 果 想 
继续 使 用 ， 只 能 重新 编写 一 段 相 同 代码 ， 这 会 产生 大 量 重复 代码 ， 不 符合 编程 的 可 重用 
性 原则 。 为 解决 这 个 问题 ， 本 章 将 会 介绍 Python 的 函数 以 及 相关 知识 点 ， 带 领 大 家 了 解 
函数 编程 。 


EXE 据 数 的 定义 与 调用 


函数 就 是 一 些 语句 的 集合 ， 它 能 够 被 多 次 执行 。 函 数 可 以 在 被 调用 的 时 候 接 收 参 数 ， 每 
次 调用 可 以 传递 不 同 的 参数 值 ， 函 数 在 执行 结束 后 还 可 以 给 调用 程序 返回 一 个 值 。 这 些 特性 
使 得 函数 可 以 帮助 开发 人 员 最 大 化 地 实现 代码 重用 与 最 小 的 代码 元 余 ， 同 时 函数 还 可 以 嵌 套 
使 用 ， 从 而 为 开发 人 员 提 供 更 多 的 流程 控制 手段 。 

Python 中 使 用 def 关键 字 定 义 函数 ， 形 式 如 下 : 


def add(x, y): 
return x t y 


此 时 函数 名 为 add， 函 数 参数 为 x 和 y， 参 数 后 必须 紧 跟 一 个 冒号 ， 这 是 Python 的 格式 
要 求 ， 函 数 体 就 是 一 句 代 码 同时 也 是 本 函数 的 返回 值 “ return x + y”, 调用 这 个 函数 的 方法 
就 是 在 函数 名 后 面 加 上 一 个 小 括号 ， 小 括号 里 面 写 上 对 应 的 参数 值 ， 例 如 为 了 计算 3+4 的 
值 ， 可 以 这 样 调用 : a = add(3, 4)。 默 认 情 况 下 ， 函 数 参 数 的 顺序 和 数量 必须 与 函数 定义 时 一 
致 ， 否 则 会 出 现 异常 ， 本 次 调用 中 会 把 数值 3 赋值 给 参数 x， 数 值 4 赋值 给 y， 最 后 将 3 + 4 
的 计算 结果 作为 返回 值 赋 值 给 变量 a。 
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5.2.4 文档 字符 串 


良好 的 代码 书写 规范 不 仅 便 于 他 人 阅读 ， 更 是 一 个 开发 人 员 应 有 的 素养 。 于 函数 往往 
用 于 实现 一 系列 复杂 的 逻辑 运算 ， 所 以 在 编写 函数 时 更 应 该 注意 代码 规范 ， 使 函数 调用 者 能 
够 准确 理解 函数 的 使 用 方法 ， 图 5-1 是 Python 内 置 的 print 函数 的 注释 。 


图 5-1 


从 截图 中 可 以 知道 ，print 函数 的 作用 是 将 一 些 值 打印 到 一 个 流 对 象 或 者 系统 的 标准 输出 


设备 。 同 时 还 提供 了 几 个 可 选 行 复 杂 的 打印 操作 

自 定义 的 函数 也 应 提供 合适 的 函数 注释 ， 帮助 使 用 者 理解 函数 

在 Python 中 使 用 文档 字符 串 (DocString) 可 以 提供 对 函数 功能 的 说 明 ， 文 档 字 符 串 存 储 
在 __doc _ 中 。 文档 字符 串 必须 出 现在 模块 、 方 法 、 类 或 者 函数 内 部 的 第 一 行 。Python 官方 
推荐 所 有 的 模块 以 及 模块 内 部 的 类 与 方法 都 应 该 有 文档 字符 串 ， 另 外 类 的 所 有 公共 方法 如 构 
XEPRA (7 inito ) 也 应 该 提供 文档 字符 串 。 

Python 推荐 使 用 三 个 双 引 号 将 文档 字符 串 括 起 来 ， 如 "Add two numbers."""。 如 果 在 文 
档 字符 串 中 出 现 了 反 斜 杠 (/)， 则 需要 在 文档 字符 串 前 添加 小 写字 母 r， 如 mr""Its a function 
to get the summary of two numbers."""。 如 果 文 档 字 符 串 中 出 现 了 unicode 字符 ， 则 需要 在 字 
符 串 前 添加 一 个 小 写字 母 u, 例如 : ut 计算 两 数 之 和 。"""。 
单行 文档 字符 串 的 书写 有 以 下 注意 事项 : 
O 即使 文档 只 有 一 行 ， 也 要 使 用 三 引号 将 字符 串 括 起 来 。 
O 如 果 文档 只 有 一 行 ， 那 么 三 引号 开头 与 结尾 也 要 在 一 行 。 
a 在 文档 字符 串 中 不 能 出 现任 何 空白 行 。 
O 文档 字符 串 用 来 描述 方法 或 函数 的 作用 ， 而 不 能 有 其 他 描述 性 的 文字 。 


D 文档 字符 串 中 不 要 重复 出 现 函数 的 签名 ， 如 "function(a, b) -> list"""。 

多 行文 档 字符 串 的 书写 有 以 下 注意 事项 : 

口 第 一 行 类 似 于 单行 文档 字符 串 ， 用 于 表达 总 结 性 的 信息 ， 其 后 紧 跟 一 个 空 行 ， 最 后 是 
更 详细 的 描述 性 信息 。 


口 总 结 性 的 信息 必须 紧 跟 在 开始 三 引号 之 后 
口 详细 的 描述 信息 的 缩 进 应 该 与 三 引号 一 臻 
一 个 包含 多 行文 档 字 符 串 的 示例 如 下 : 
def complex(real-0.0, imag-0.0): 
"""Form a complex number. 
Keyword arguments: 
real -- the real part (default 0.0) 
imag -- the imaginary part (default 0.0) 


"nn 


if imag == 0.0 and real == 0.0: 
return complex zero 


此 时 在 Visual Studio Code 中 调用 上 面 complex 方法 时 也 会 给 出 提示 信息 ， 如 图 5-2 
所 示 


图 5-2 


5.2.2 ”函数 注释 


除了 文档 字符 串 外 ， 在 Python 3 中 还 提供 了 一 个 新 功能 : 函数 注释 。 函 数 注释 完全 是 一 
个 可 选 的 功能 ， 它 以 字典 的 形式 存储 在 ”annotations _ 中 ， 不 会 对 函数 本 身 造 成 任何 影响 。 
函数 注释 的 使 用 方法 为 : 


def 函数 名 ($305: "参数 注释 "=" 默认 值 "，…) -> " 函数 返回 值 注释 ": 
函数 体 


fil: 修改 add 方 法， 添加 相应 的 函数 注释 : 
def add(x:"Number 1"-0, y:"Number 2"-0) -> int: 


"""Add two numbers.""" 
retbrn x +y 
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调用 add 方法 : 


| 
= 


由 此 可 见 ， 函 数 参数 、 返 回 值 的 说 明 信 息 都 被 保存 在 属性 — annotations — 中 , 方便 用 
户 了 解 并 使 用 函数 。 


因数 参数 


5.3.1 位 置 参 数 


位 置 参 数 就 是 在 调用 的 时 候 必须 要 按照 正确 顺序 传人 的 参数 ， 调 用 时 的 数量 必须 与 函数 
声明 一 致 。 如 加 法 运算 函数 中 的 参数 x 和 y， 调 用 时 必须 要 接收 两 个 参数 ， 这 就 是 位 置 参 数 。 


5.3.2 ”默认 参数 


某 些 时 候 函 数 的 参数 值 很 少 发 生变 化 ， 因 此 为 了 简化 调用 方法 ， 我 们 将 这 类 很 少 变化 的 
参数 设置 成 默认 参数 ， 调 用 时 不 传递 参数 值 ， 此 时 函数 内 部 使 用 默认 值 。 

下 面 是 一 个 使 用 了 默认 参数 的 函数 ， 该 函 数 用 来 计算 整数 的 na 次 方 ， 在 数学 运算 中 绝 大 多 
数 情 况 下 只 进行 平方 运算 ， 对 于 高 次 方 的 运算 很 少 ， 基 于 此 设置 函数 第 二 个 参数 的 默认 值 为 2 


使 用 下 面 参数 调用 power 函数 : 


| 
= 


数 需要 放 在 必 选 参数 之 后 ， 如 果 有 多 个 默认 参数 ,那么 所 有 默认 参数 都 要 放 在 


口 只 为 很 少 变 化 的 参数 设置 默认 参数 。 

下 面 举 一 个 现实 中 使 用 默认 参数 的 例子 ， 在 小 学 生 和 学 登记 时 需要 填写 学 生 姓 名 、 人 性 
别 、 年 龄 、 城 市 信息 。 分 析 需 求 发 现 ， 对 于 一 所 学 校 的 新 生 ， 他 们 的 年 龄 基本 一 致 都 是 7 岁 
或 8 岁 人 学 ， 而 城市 基本 一 致 ， 性 别 只 有 男 、 女 两 种 情况 。 由 此 可 见 ， 如 果 将 性 别 、 年 龄 、 
城市 设置 为 默认 参数 的 话 会 大 大 提高 学 生 信息 录入 效率 ， 据 此 编写 函数 ， 如 图 5-3 所 示 

输出 结果 如 图 5-4 所 示 


图 5-3 


5.3.3 ”关键 字 参 数 


Python 中 有 两 种 类 型 的 关键 字 参 数 : 
Q 对 于 函数 调用 方 ， 可 以 使 用 参数 名 传递 参数 值 的 参数 ; 
O 对 于 函数 定义 方 ， 可 以 定义 一 个 参数 ， 这 个 参数 类 似 于 **kwargs 形式 ， 这 个 参数 会 
交 收 所 有 命名 参数 。 
上 面 关于 小 学 生 信 息 注 册 的 函数 就 属于 第 一 种 关键 字 参 数 ， 我 们 发 现 ， 在 调用 register 
函数 的 时 候 使 用 了 类 似 于 gender =' 男 ' 这 样 的 写法 ,这 就 是 第 一 种 关键 字 参 数 。 

下 面 以 第 二 种 情况 举 个 例子 : 

编写 函数 : 


def foo(*positional, **keywords): 
print("Positional:", positional) 
print("Keywords:", keywords) 


s [NN 
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调用 函数 : 


输出 : 


由 此 可 见 参数 *positional 接收 了 全 部 位 置 参数 (positional argument) 。 
下 面 再 看 看 关键 字 参 数 的 调用 : 


输出 : 


此 时 虽然 传递 的 参数 个 数 、 参 数值 都 没有 变 , 但 是 为 每 个 参数 都 传递 了 名 字 ， 输 出 结果 
正好 相反 ， 第 一 次 *positional 接收 了 参数 ， 第 二 次 **keywords 接收 了 参数 。 另 外 还 可 以 看 
出 positional 是 元 组 类 型 ，keywords 是 字典 类 型 。 

下 面 再 看 一 个 混合 调用 的 情况 : 


输出 : 


符合 我 们 的 推测 ，*positional 接收 位 置 参数 , **keywords 接收 命名 参数 。 
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异常 就 是 代码 执行 过 程 中 非 预期 的 执行 结果 ， 随 着 代码 越 来 越 复 杂 ， 代 码 中 的 执行 逻辑 
也 会 越 来 越 复杂 ， 如 果 没 有 很 好 地 处 理 异 常情 况 ， 很 有 可 能 造成 软件 执行 错误 甚至 造成 重大 
损失 。 反 之 , 合理 地 处 理 异常 情况 ， 可 以 增强 软件 的 稳定 性 ， 提 高 用 户 体验 。 


E s 


Python 用 异常 对 象 ( exception object) 来 表示 代码 执行 过 程 中 所 发 生 的 异常 情况 ， 每 当 
程序 遇 到 错误 时 就 会 抛 出 异常 。 此 时 如 果 没 有 正确 处 理 异 常 ， 代 码 将 会 终止 执行 。 

前 面 章 节 中 已 经 提 到 过 Python 的 异常 ， 如 访问 的 字典 的 键 不 存在 ,会 输出 错误 : 

>>> roomnumber ["Richard"] 

Traceback (most recent call last): 


File "«stdin»", line 1, in «module» 
KeyError: 'Richard' 


如 果 在 产品 中 遇 到 异常 情况 也 这 样 处 理 的 话 ， 那 么 可 以 想象 这 款 产 品 会 多 么 难 用 。 为 了 
提高 产品 的 稳定 性 与 灵活 性 ，Python 允许 开发 人 员 捕 提 并 处 理 各 类 异常 ， 本 例 中 的 异常 是 
KeyError 异常 类 的 一 个 实例 。 


DE 错误 与 异常 


在 学 习 如 何 处 理 异 常 之 前 ， 先 要 了 解 Python 中 有 哪些 导致 异常 的 错误 。Python 将 代码 
的 错误 分 为 两 类 : 语法 错误 (syntax error) 和 异常 (exception). 


6.2.44 语法 错误 


语法 错误 也 就 是 代码 解析 错误 。 这 类 错误 往往 出 现在 Python 初学 者 身上 ， 出 现 这 类 错 
误 的 原因 是 所 执行 的 代码 不 符合 Python 的 语法 规范 ， 因 此 Python 解释 器 抛 出 语法 错误 并 终 
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止 代码 执行 。 
执行 下 面 代码 会 出 现 语法 错误 : 


这 个 错误 出 现 的 原因 是 while 的 布尔 表达 式 后 缺少 冒号 ， 不 符合 while 语句 的 语法 规 
范 。 此 时 Python 解释 器 在 最 早 发 现 错误 的 位 置 输出 一 个 箭头 标记 ， 提 示 开 发 人 员 检 查 附 近 
的 语法 错误 。 


622 异常 


异常 是 在 代码 执行 过 程 中 所 发 现 的 错误 ， 这 类 错误 是 很 难 被 提前 发 现 的 ， 即 使 我 们 的 
Python 脚本 书写 完全 符合 规范 也 有 可 能 出 现代 码 执 行 异常 。 

比较 常 被 提 到 的 一 个 异常 情况 就 是 除数 为 0 异常。 我 们 知道 数学 运算 中 除数 是 不 能 等 于 
0 的 ， 如 果 编 写 了 一 个 除法 算法 函数 ， 用 户 调用 时 将 除数 赋值 为 0， 那 么 就 会 出 现 除数 为 0 
的 异常 ; 


[E 异常 处 理 


THET Python 中 的 错误 与 异常 之 后 ， 就 需要 掌握 如 何 处 理 异 常 。 

对 于 第 一 类 语法 错误 ， 只 能 通过 提高 自身 能 力 水 平 来 避免 。 对 于 第 二 类 异常 ，Python 提 
供 了 try-except 语法 来 处 理 。 

还 是 以 除数 为 0 的 情况 为 例 ， 编 写 程序 ， 通 过 添加 try-except 语法 捕捉 并 处 理 异常 : 


调用 division 方法 : 
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输出 : 


此 时 虽然 除数 为 0， 但 是 应 用 程序 并 没有 崩溃 而 且 还 输出 了 比较 友好 的 信息 。 

Try-except 的 工作 原理 如 下 : 

(1) Try-except 中 的 代码 会 被 正常 执行 ; 

(2) 如 果 没 有 出 现 异 常 则 跳 过 except 代码 块 并 结束 try-except; 

(3) 如 果 try-except 中 的 某 一 句 代 码 出 现 了 异常 情况 ， 剩 余 的 代码 将 不 会 执行 ， 如 果 出 
现 的 异常 与 except 所 指定 的 异常 一 致 ， 则 执行 except 中 的 代码 块 ， 异 常 处 理 结束 整个 应 用 程 
序 继续 执行 ; 

(4) 如 果 出 现 的 异常 与 except 中 所 指定 的 异常 不 匹配 ， 那 么 代码 跳出 try 语句 ， 程 序 继 
续 抛 出 异常 并 终止 执行 。 

一 般 来 说 ， 一 个 代码 块 可 能 会 出 现 不 止 一 种 异常 情况 ， 此 时 可 以 将 所 有 异常 写 在 except 
语句 中 ， 形 式 如 下 : 


此 时 只 要 捕捉 到 异常 列表 中 的 任意 一 种 异常 都 会 进入 except 处 理 代码 块 进行 处 理 。 
如 果 想 对 每 一 种 异常 都 进行 个 性 化 的 处 理 ， 也 可 以 将 except 拆 分 开 来 ， 修 改 上 面 代码 加 
人 更 多 异常 处 理 情况 : 


调用 division 方法 : 


输出 : 


注意 ,Python 中 的 异常 类 型 是 有 继承 关系 的 ， 关 于 类 的 集成 会 在 后 面 章节 详细 介绍 。 在 
这 里 只 要 知道 如 果 后 面 except 所 指定 的 异常 继承 自前 面 异 常 的 话 ， 后 面 的 异常 也 会 被 捕捉 
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到 。 看 下 面 的 例子 : 


代码 执行 输出 : 


如 果 将 except 的 顺序 颠倒 过 来 ， 将 只 会 输出 也， 这 是 由 于 异常 C 和 D 都 继承 自 异常 B， 
所 以 第 一 次 捕捉 到 B 异常 后 就 会 终止 执行 : 
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此 时 读者 可 能 会 想 ， 代 码 开发 中 的 异常 有 很 多 ， 如 果 都 像 这 样 将 每 一 种 异常 都 提取 出 
来 ， 将 会 是 一 个 很 大 的 工作 量 而 且 也 并 不 需要 这 样 做 ， 此 时 可 以 在 最 后 一 个 except 中 不 设置 
异常 类 型 ,这样 最 后 一 个 except 就 会 捕获 所 有 前 面 没有 指定 的 异常 ， 如 : 


最 后 一 个 except 将 会 捕获 除 ZeroDivisionError 和 TypeError 之 外 的 所 有 异常 。 
try-except 语法 还 有 一 个 重要 功能 : else; else 语句 是 用 来 执行 一 些 额 外 操作 的 ， 如 try 
代码 块 中 执行 了 一 些 文件 操作 ， 在 else 里 面 可 以 释放 资源 ，else 的 语法 格式 如 下 : 


最 后 需要 了 解 的 是 Python 代码 可 以 操作 异常 ， 形 式 如 下 : 


调用 division 方法 : 
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DX ness 


在 软件 开发 中 有 些 情 况 虽 然 Python 并 没有 执行 出 错 ， 但 是 可 能 不 符合 软件 设计 逻辑 ， 
所 以 需要 开发 人 员 主 动 抛 出 异常 ， 此 时 可 以 使 用 raise 语句 抛 出 异常 ， 例 如 : 


HA anexi 


有 时 Python 内 置 的 异常 并 不 能 满足 开发 需要 ， 或 者 由 于 其 他 原因 ， 开 发 人 员 和 希望 能 够 
有 更 灵活 的 异常 类 型 来 处 理 各 种 各 样 的 应 用 场景 ， 此 时 可 以 开发 自 定义 异常 。 

自 定义 异常 类 必须 要 直接 或 者 间接 地 继承 自 Exception 类 (关于 类 与 继承 的 知识 将 在 后 
面 章 节 中 介绍 )。 自 定义 异常 类 可 以 像 其 他 类 一 样 做 任何 事情 ， 但 是 原则 上 要 保持 代码 简洁 ， 
通常 只 提供 一 些 属性 就 够 了 。 

下 面 是 关于 创建 模块 的 自 定义 异常 类 的 例子 。 
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前 面 介绍 的 else 是 在 代码 正常 执行 后 才 会 被 执行 的 代码 块 ， 但 是 有 些 情况 下 无 论 代码 块 
是 否 出 现 异 常 都 需要 执行 ， 对 于 这 类 代码 可 以 放 在 finally 语句 中 ， 例 如 : 


第 7 章 
面向 对 象 编程 


[面向 对 象 编程 介绍 


面向 对 象 编程 ( Object-Oriented Programming, OOP) 是 一 种 编程 规范 ， 它 将 世间 万 物 都 视 为 
对 象 (object)， 具 有 相似 属性 与 行为 的 对 象 的 集合 叫 作 类 ( class)， 每 一 个 具体 的 对 象 就 是 类 的 一 
个 实例 (instance)。 比 如 汽车 就 可 以 看 作 是 一 个 类 ， 每 辆 汽车 都 有 自己 的 品牌 、 颜 色 等 参数 Om 
性 )， 汽 车 还 包括 行驶 、 转 弯 等 行为 (方法 )， 跑 在 路 上 的 每 一 辆 汽车 就 是 汽车 类 的 一 个 实例 。 

对 象 之 间 可 以 有 不 同 的 属性 与 行为 ， 也 可 以 有 相同 的 属性 与 行为 。 某 些 属性 或 者 行为 对 
于 所 有 对 象 都 是 相同 的 ， 可 以 将 之 归 类 于 类 的 属性 和 行为 ， 一 旦 这 类 属性 发 生变 化 则 所 有 对 
象 实例 都 会 发 生变 化 。 例 如 目前 每 辆 汽车 都 有 一 个 驾驶 员 座 椅 ， 如 果 将 来 自动 驾驶 技术 得 到 
普及 ,不 再 需要 驾驶 员 驾 驶 汽车 了 ， 则 可 以 将 汽车 类 的 驾驶 员 修 改 为 人 工 智能 ， 这 样 所 有 汽 
车 实例 的 驾驶 员 都 变 成 了 人 工 智能 。 其 他 属性 如 颜色 则 不 能 属于 类 ， 因 为 每 一 辆 汽车 都 可 以 
有 自己 的 颜色 ， 所 以 这 类 属性 或 方法 就 属于 对 象 。 


Python 是 一 种 纯粹 的 面向 对 象 语言 ， 在 Python 语言 中 任何 变量 都 是 类 的 实例 ， 比 | 
如 一 个 整数 就 是 int 类 的 对 象 实例 : | 


>>> type(2) 
1 <class 'int'» 


7.2.4 创建 第 一 个 类 


Python 使 用 class 关键 字 表 示 类 ， 下 面 是 一 个 最 简单 的 类 : 
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关键 字 class 代表 当前 代码 是 一 个 类 的 定义 ，Car 表示 当前 类 的 名 字 ， 其 后 有 一 个 冒号 ， 
冒号 后 的 代码 是 类 的 具体 实现 ， 本 例 中 的 类 体 为 空 。 

空 类 在 现实 中 没有 什么 意义 ， 所 以 我 们 根据 需求 对 这 个 类 进行 扩展 。 

汽车 包含 品牌 和 颜色 属性 ， 同 时 还 可 以 行驶 ， 所 以 根据 以 上 分 析 给 Car 类 添加 属性 和 
方法 : 


现在 一 个 汽车 类 已 经 创建 好 了 ， 它 的 默认 品牌 是 “宝马 ”， 颜 色 是 “红色 ”， 还 有 一 个 行 
驶 的 方法 。 


7.2.2 ”实例 化 


定义 好 类 之 后 ， 就 需要 使 用 该 类 了 ， 首 先 创建 一 个 类 的 实例 ， 这 就 好 比 需要 一 辆 真正 的 
汽车 才 可 以 上 路 一 样 ，Python 不 像 其 他 语言 需要 new 关键 字 来 实例 化 类 ，Python 只 需要 使 用 
类 名 +0 就 可 以 实例 化 一 个 类 : 


使 用 点 C.) 来 调用 属性 与 方法 : 


注意 ,读者 可 能 会 对 abrand 这 样 的 用 法 感觉 有 点 奇怪 ， 其 实 这 样 确实 不 合适 ， 后 面 会 
具体 介绍 。 


7.2.8 self 参数 
在 这 里 ， 读 者 可 能 注意 到 run 函数 有 两 个 参数 ， 其 中 第 一 个 参数 是 self， 而 在 调用 的 时 
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候 并 没有 传递 值 给 self， 这 其 实 是 Python 规定 的 类 的 方法 必须 要 有 的 一 个 参数 ， 并 没有 什么 
特殊 意义 ， 在 调用 的 时 候 也 不 需要 给 它 传 值 。 可 以 为 Car 类 添加 一 个 print. self 方法 查看 self 
到 底 是 什么 。 


调用 print_self 方 法 : 


从 以 上 输出 结果 可 以 看 出 ，self 代表 当前 类 的 实例 ， 而 self，_class ”就 是 Car 类 。 


7.24 ”类 变量 


像 brand, color 这 类 变量 叫 作 类 变量 ， 是 所 有 类 实例 共享 的 变量 。 类 变量 定义 在 类 中 但 
是 不 属于 任何 函数 。 虽 然 可 以 像 前 面 例子 一 样 使 用 类 实例 来 访问 并 修改 类 变量 ， 但 是 不 建议 
这 样 做 ， 因 为 当 某 一 个 类 实例 修改 了 类 变量 后 ， 可 能 会 对 其 他 类 实例 的 使 用 造成 影响 ， 也 会 
使 开发 人 员 难 以 确定 当前 类 变量 的 值 ， 尤 其 是 可 变 对 象 的 值 。 

正确 的 用 法 是 使 用 “类 名 . 属性 ”的 方式 访问 类 的 属性 : 


创建 两 个 Car 实例 ， 查 看 它们 的 brand: 


第 7 章 mmus 5 |E 


可 见 两 个 实例 的 brand 属性 所 指向 的 内 存 地 址 相同 ， 这 就 意味 着 如 果 修 改 了 Car.brand, 
那么 实例 a 和 的 brand 值 都 会 发 生变 化 : 


7.2.5 ”实例 变量 


看 到 类 变量 的 特性 ， 可 能 会 想到 对 于 品牌 与 颜色 这 类 属性 ， 每 辆 汽车 都 可 能 不 相同 ， 那 
么 在 Python 里 面 要 如 何 表示 呢 ? 

对 于 这 种 类 型 的 属性 ， 可 以 使 用 实例 变量 来 存储 ， 实 例 变量 是 定义 在 方法 中 的 变量 ， 只 
能 用 于 当前 类 的 实例 。 使 用 实例 变量 修改 上 面 代码 : 


方法 _ init _0 叫 作 构造 函数 ， 每 当 实例 化 一 个 类 时 都 会 执行 这 个 函数 ， 通 常会 在 这 个 
函数 里 面 为 实例 属性 进行 初始 化 ， 所 以 也 叫 作 初始 化 方法 。 此 时 再 实例 化 Car 类 时 就 必须 按 
照 _init _0 的 格式 实例 化 了 ， 不 能 直接 使 用 Car0 的 方式 了 : 
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类 继承 


继承 是 代码 重用 的 好 办 法 ，Python 中 的 继承 就 像 现 实生 活 中 的 继承 一 样 ， 子 类 可 以 什么 
都 不 做 就 拥有 了 父 类 的 属性 或 方法 。 


7.8.01. 单 继承 


单 继 承 就 是 一 个 子 类 只 有 一 个 基 类 的 继承 方式 ， 语 法 是 : class 子 类 名 ( 基 类 名 ): …。 

还 是 以 汽车 为 例 来 讲解 单 继承 。 汽 车 不 是 只 有 燃油 的 传统 小 汽车 ， 还 有 特 斯 拉 这 种 电动 
车 ， 虽 然 它们 都 是 汽车 ， 都 有 品牌 、 颜 色 等 属性 ， 但 是 在 一 些 细节 上 还 是 有 区 别 的 。 据 此 可 
以 定义 一 个 Car 基 类 ， 它 包含 所 有 汽车 的 通用 属性 ， 然 后 再 定义 一 个 OilCar 类 和 ECar 类 分 
别 代表 燃油 汽车 和 电动 车 : 
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接 下 来 分 别 实例 化 OilCar 和 了 ECar 类 ， 看 看 它们 是 不 是 真 的 能 够 使 用 基 类 的 属性 与 方法 : 


由 此 可 见 ， 对 象 o 是 OilCar 类 型 ， 同 时 也 是 Car 的 一 个 实例 。 子 类 不 但 可 以 直接 使 用 父 
类 的 属性 (brand, color) 与 方法 (print_car)， 而 且 还 可 以 增加 新 方法 (power)。 


7.3.2 ”多 继承 


多 继承 就 是 一 个 子 类 可 以 继承 多 个 父 类 的 继承 方式 ， 相 对 于 单 继承 来 说 ， 多 继承 更 复 
杂 也 更 难以 控制 ， 容 易 造 成 鞭 形 继承 问题 ， 即 两 个 父 类 同时 继承 了 一 个 基 类 ， 而 子 类 会 包含 
多 个 父 类 的 内 容 ,产生 代码 歧义 ， 因 此 很 多 编程 语言 都 据 弃 了 这 种 继承 方式 如 Java 和 C#。 
Python 是 允许 多 继承 的 ， 这 对 于 开发 人 员 来 说 即 提供 了 更 多 的 代码 编写 方案 ， 同 时 也 引入 了 
更 多 的 潜在 问题 ， 因 此 开发 人 员 应 时 刻 注意 多 继承 的 风险 。 

虽然 编者 并 不 建议 开发 人 员 使 用 多 继承 的 方式 编写 代码 ， 但 是 仍 在 这 里 对 多 继承 做 一 个 
简单 介绍 ， 多 继承 的 语法 与 单 继承 类 似 : class 子 类 名 ( 基 类 1, 基 类 2…): …。 下 面 是 一 个 非 
常 简单 的 多 继承 的 例子 : 


| 58 Django 2.0 入 门 与 实践 


类 C 同时 继承 了 类 A 和 类 B， 那么 它 应 该 同时 拥有 类 A 和 类 B 的 属性 与 方法 ， 执 行 以 
下 代码 进行 查看 : 


上 面 的 代码 非常 简单 ， 因 为 类 A 和 类 B 既 没 有 构造 函数 也 没有 重复 的 属性 和 方法 ， 那 
么 如 果 它 们 都 有 构造 函数 并 且 有 同名 的 方法 时 会 发 生 什么 呢 ? 


执行 以 下 代码 : 
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从 上 面 的 执行 结果 来 看 ， 本 来 我 想 介绍 我 的 年 龄 ， 但 是 却 输 出 了 “我 叫 18"， 而 另外 两 
个 方法 还 能 正常 执行 。 这 种 现象 是 继承 顺序 导致 的 ， 类 A 在 类 B 的 前 面 ， 所 以 对 于 同名 的 属 
性 与 方法 子 类 都 会 调用 类 A 的 。 

上 面 是 普通 方法 在 多 继承 中 的 表现 ， 对 于 构造 方法 来 说 就 更 复杂 了 。Python 中 类 的 构造 
方法 基本 按照 以 下 方式 执行 。 

如 果子 类 有 自己 的 构造 方法 ， 那 么 在 实例 化 子 类 的 时 候 就 会 执行 子 类 的 构造 方法 ， 不 会 
执行 基 类 的 构造 方法 ， 例 如 : 


如 果子 类 没有 构造 方法 ， 在 单 继承 中 则 会 直接 调用 基 类 的 构造 方法 ， 例 如 : 
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如 果子 类 有 多 个 基 类 并 且 子 类 没有 自己 的 构造 函数 ， 则 会 按 顺 序 查找 父 类 ， 找 到 第 一 个 
有 构造 函数 的 基 类 并 执行 ， 例 如 : 


7.8.8 方法 重 载 


有 时 虽然 父 类 已 经 提供 了 一 些 方法 ， 但 是 这 些 方法 可 能 不 能 满足 子 类 的 需求 ， 所 以 可 以 
在 子 类 中 对 父 类 方法 进行 重 写 。 

还 是 以 单 继承 为 例 ， 前 面 的 例子 中 子 类 OilCar 和 ECar 都 直接 使 用 了 父 类 的 print caro 
方法 ， 接 下 来 希望 在 print_car() 函数 的 输出 中 还 能 展示 当前 车 辆 的 动力 类 型 ， 此 时 就 需要 重 
写 父 类 的 print car 方法 ， 具 体 修改 如 下 : 
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重新 调用 print. carQ 方法 查看 执行 结果 : 


执行 正常 ， 子 类 已 经 重 写 了 父 类 方法 ， 而 且 不 同 的 子 类 之 间 没 有 十 扰 。 


7.83.4 super 函数 


仔细 观察 上 面 方法 重 载 的 例子 可 以 发 现 ， 两 个 子 类 中 print carQ 非常 相似 ， 只 有 很 少 的 
一 部 分 代码 有 区 别 ， 本 着 代码 重用 原则 ， 可 以 使 用 super 函数 在 子 类 中 调用 父 类 方法 ， 以 达 
到 减少 子 类 代码 元 余 的 目的 。 

Super 是 Python 的 内 置 函 数 ， 可 以 用 来 调用 父 类 的 方法 ， 这 在 方法 被 重 载 时 非常 有 用 。 
Super 函数 的 语法 : super([type[;object-or-type]])- 

Super 函数 有 两 种 用 法 : 四 在 单 继承 结构 中 ，super 可 以 隐 式 地 返回 父 类 。@) 支 持 多 继承 ， 
这 也 是 除 Python 外 几乎 目前 所 有 编程 语言 中 唯一 一 种 能 做 到 合理 使 用 多 继承 的 方式 ，super 
使 得 开发 人 员 可 以 很 好 地 解决 凌 形 继承 问题 。 不 管 哪 种 用 法 ，super 的 调用 都 类 似 下 面 形式 : 
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super 这 种 不 传 参 数 的 用 法 只 能 用 在 类 方法 中 ，Python 解释 器 会 自动 填充 参数 。 
第 二 个 参数 object-or-type 一 般 都 是 self, 


了 解 了 以 上 知识 后 ， 使 用 super 修改 上 面 代码 : 
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7.3.5 ”访问 权限 


前 面 例子 中 所 有 类 的 属性 与 方法 都 是 公有 的 ， 也 就 是 说 ， 子 类 可 以 没有 限制 地 使 用 基 类 
的 任何 成 员 。 但 是 有 时 还 需要 对 类 成 员 的 访问 权限 加 以 控制 ， 如 只 允许 类 内 部 使 用 ， 或 者 只 
允许 类 本 身 和 子 类 使 用 。 

口 类 的 私有 属性 如 下 。 

__private_attrs : 以 两 个 下 画 线 开 头 ， 不 能 在 类 的 外 部 使 用 ， 在 类 内 部 使 用 时 : self 
private _attrs。 

口 类 的 私有 方法 : 

. private methods : 以 两 个 下 面 线 开头 ,不 能 在 类 的 外 部 使 用 ， 在 类 内 部 使 用 时 : 
self. private methods. 


读者 可 通过 下 面 的 例子 看 看 私有 属性 与 公有 属性 的 区 别 : 


访问 公有 变量 与 私有 变量 : 
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可 见 在 类 外 部 是 不 能 访问 私有 变量 的 ， 但 是 其 实 Python 的 私有 变量 是 一 个 伪 私 有 变量 ， 
使 用 dir 函数 (dir 是 Python 的 内 置 函 数 ， 可 以 用 来 查看 对 象 的 所 有 属性 与 方法 ) 查看 实例 at: 


从 输出 结果 可 见 ，at 包 含 了 一 个 属性 _AccessTest _private， 这 个 属性 其 实 就 是 我 们 前 
面 定 义 的 ^ private 属性 ， 这 是 Python 的 名 称 修饰 ( name mangling) 功能 对 __private 的 重合 
名 。 我 们 继续 访问 这 个 AccessTest private 属性 ， 看 看 它 是 不 是 真 的 等 于 ^ private WE? 


果然 符合 预期 。 


EZI vaut 


前 面 介 绍 了 Python 类 的 基本 用 法 ， 下 面 再 来 介绍 几 个 Python 类 的 内 置 属 性 。 
Q doc : 文档 字符 串 。 


Q cas : 类 名 。 
口 _module : 类 所 在 模块 名 。 
口 _name : 类 名 。 


Q dit : 由 类 的 数据 属性 组 成 的 字典 。 
口 _base _: 基 类 。 


第 7 章 ums o5 EN 


类 的 内 置 属性 : 


第 8 章 
模块 


前 面 讲 的 都 是 Python 的 具体 语法 ， 接 下 来 讲解 一 下 模块 。 模 块 其 实 就 是 一 个 包含 了 
Python 代码 的 文件 ， 一 般 扩展 名 是 py。 模块 中 可 以 包含 类 、 函 数 、 变 量 等 任何 代码 。 

使 用 模块 的 好 处 很 多 ， 如 可 以 将 大 量 的 代码 分 配 到 多 个 文件 中 ， 提 高 代码 的 可 读 性 ， 
方便 维护 ; 将 相同 名 字 的 函数 、 类 或 者 变量 放 在 不 同 的 模块 中 可 以 避免 命名 冲突 ;提高 代 
码 的 可 重用 性 ， 只 要 将 写 好 的 代码 放 到 模块 中 ， 那 么 其 他 模块 就 可 以 引用 这 个 模块 里 面 的 
代码 。 

当然 不 同人 编写 的 模块 也 可 能 重 名 ， 因 此 Python 通过 将 模块 放 入 不 同文 件 夹 的 方式 来 
避免 模块 重 名 ， 这 个 文件 夹 就 叫 作 包 (package)。 


init _.py 文件 内 可 以 什么 都 不 写 。 


| 每 个 包 下 面 必须 包含 一 个 _init py 文件， 否则 Python 会 认为 这 是 一 个 普通 目录 。 


EX]p 创建 模块 


下 面 创建 一 个 简单 的 模块 Carpy: 
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这 个 模块 与 之 前 编写 的 代码 唯一 的 区 别 是 最 下 面 代码 块 :f_name —— main ees 


这 个 站 条 件 判断 语句 是 用 来 判断 当前 代码 的 执行 位 置 的 ， 如 果 直 接 执 行 这 个 模块 ， 那 么 
Python 解释 器 会 将 一 个 特殊 变量 — name _ 设置 为 ”main _， ifi WAT. Ul 


如 果 通 过 导入 到 其 他 模块 的 方式 使 用 Car 模块 的 话 ,让 语句 判断 失败 ,让 代 码 块 不 会 执行 。 
可 以 在 让 语句 前 打印 出 __name _ 来 验证 猜测 : print( name ). 
重新 执行 上 面 代码 : 


创建 其 他 模块 test.py， 在 test 模块 中 引用 Car.py, test.py 模块 内 容 如 下 : 


执行 test.py 输出 : 


E E 
说 明 在 其 他 模块 引用 时 特殊 变量 name MERA, TUR main- 


导入 模块 


8.2.1 导入 整个 模块 
直接 使 用 “ import 模块 名 ”的 方式 可 以 导入 整个 模块 ， 上 面 testpy 模块 引用 Car 模块 的 
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方式 就 是 这 种 ， 在 test 中 使 用 Car 模块 内 容 时 必须 这 样 引用 : 模块 名 . 函数 名 ， 如 : 


另外 也 可 以 使 用 “from 模块 名 import* ”的 方式 导入 整个 模块 。 


8.2.2 “导入 部 分 模块 
如 果 一 个 模块 很 大 ， 而 我 们 只 需要 模块 的 一 部 分 ， 那 么 可 以 使 用 下 面 方式 导入 模块 的 一 


| 
> 


8.2.3 import 语法 规范 
每 一 个 模块 都 使 用 单独 的 import 语句 ， 如 : 


不 要 使 用 一 个 import 语句 导 人 多 个 模块 ， 如 : 


除了 模块 的 注释 与 文档 说 明 外 ， 永 远 将 import 语句 放 在 文件 的 最 开头 位 置 ， 模 块 的 全 局 
变量 和 常量 要 放 在 import 语句 后 面 。 

按照 以 下 顺序 排列 import 语句 : 

( 1) Python 标准 库 模 块 ; 

( 2) Python 第 三 方 模块 ; 

(3) 自 定义 模块 ; 

(A) 在 上 面 每 种 模块 类 型 之 间 插入 一 行 空 行 。 

推荐 使 用 绝对 导入 (absolute imports), 4N: 


显 式 相对 导入 (relative imports) 是 另 一 种 替代 方案 : 


需要 注意 的 是 ， 隐 式 相对 导入 在 Python 3 中 已 经 被 移 除 了 。 
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使 用 下 面 方式 导入 模块 中 的 类 : 


如 果 模 块 中 的 类 名 与 本 地 脚本 中 的 类 名 重复 了 ， 可 以 使 用 以 下 方式 : 


此 时 在 本 地 脚本 中 用 以 下 方式 调用 模块 中 的 类 : 


避免 使 用 通配符 导入 模块 (from «module» import *)， 因 为 这 种 方式 会 使 读者 不 清楚 导入 
了 哪些 对 象 。 


EE 模 基 检索 顺序 


通过 上 面 的 学 习 ， 可 以 知道 Python 使 用 import 命令 导入 模块 ， 虽 然 在 导入 模块 的 时 候 
并 没有 指定 模块 所 在 路 径 ， 但 是 Python 仍然 能 够 找到 正确 的 模块 ,那么 Python 是 如 何 找到 
正确 模块 的 呢 ? 其 实 这 是 由 Python 的 模块 检索 顺序 决定 的 ，Python 解释 器 会 按照 一 定 的 顺 
序 进行 检索 ， 直 到 找到 第 一 个 匹配 的 模块 。 

从 Python 3 开始 所 有 的 导入 都 默认 为 绝对 导入 ， 这 意味 着 Python 解释 器 会 首先 在 系统 
包 中 查找 ， 当 系统 包 中 不 存在 指定 包 时 才 查 找 本 地 包 。 

相对 导入 可 以 直接 导入 同一 个 包 中 的 不 同 模块 ， 使 用 时 只 要 直接 在 模块 名 前 加 上 包 名 或 
者 点 ， 例 如 : 


Python 解释 器 按照 下 面 顺序 搜索 模块 : 

首先 判断 当前 模块 是 不 是 Python 内 建 模 块 ， 如 果 是 则 引用 内 建 模块 ， 如 果 不 是 则 在 sys. 
path 中 查找 。 

sys.path 包含 : 

Q 脚本 当前 位 置 ; 

Q shell 变量 PYTHONPATH 下 的 每 个 目录 ; 

口 安装 Python 的 依赖 位 置 。 

下 面 是 一 个 sys.path 的 例子 : 
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注意 上 面 路 径 中 存在 一 个 特殊 路 径 : "， 它 表示 当前 包 所 在 路 径 ， 这 意味 着 同一 路 径 下 
的 包 可 以 互相 引用 。 


Web 编程 基础 


Sons sc HTML 基础 
第 10 章 CSS 基础 
第 11 JavaScript 基础 
Lp 


P 
P 
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第 9 章 
HTML 基础 


HTML ( Hyper Text Markup Language) 的 中 文 全 称 叫 作 超 文 本 标记 语言 ， 是 创建 网 页 应 
用 的 标准 语言 。HTML 不 像 Python 等 开发 语言 ， 它 是 一 种 标记 语言 (markup language)， 超 
文本 的 意思 就 是 说 它 是 一 种 超越 文本 的 语言 ， 在 记事 本 里 面 输入 的 文字 是 文本 ， 超 文本 不 仅 
可 以 包含 文字 ， 还 可 以 包含 图 片 、 链 接 、 视 频 、 音 乐 等 HTML 语言 可 以 用 来 描述 网 页 结构 ， 
浏览 器 接收 从 服务 器 端 或 者 本 地 发 送 来 的 HTML 文档 进行 解释 ， 最 终 呈现 在 我 们 面前 的 就 是 
丰富 多 彩 的 网 页 了 ， 本 章 带 领 大 家 了 解 HTML 基础 。 


EXE HTML 的 历史 


HTML 语言 最 早 由 科学 家 Tim Berners-Lee 在 1980 年 开始 构思 开发 ， 经 过 近 十 年 的 发 
展 ， 终 于 在 1991 年 发 布 了 第 一 个 版 本 ， 这 个 版 本 的 HIML 叫 作 “HTML tags”"， 此 时 的 
HTML tags 包含 了 18 个 元 素 ， 能 够 描绘 简单 的 网 页 。 

Berners-Lee 一 直 致 力 于 推动 HTML 成 为 一 种 标准 通用 语言 ( Standard Generalized 
Markup Language，SGML )， 终 于 在 1993 ^E, HTML 正式 被 互联 网 工程 任务 组 ( Internet 
Engineering Task Force, IETF) 接纳 ， 并 由 Berners-Lee fil Dan Connolly 共同 起 草 了 第 一 版 
HTML 规范 ( Hypertext Markup Language，HTML)。 而 几乎 同时 代 的 Dave Raggett 于 1993 
年 完成 了 HTML- (Hypertext Markup Format). 

1994 4E, IETF 组建 了 HITML 工作 组 并 于 1995 年 完成 了 HTML 2.0 规范 的 制定 ， 这 个 
版 本 的 HTML 规范 成 为 后 来 HTML 的 基础 。 自 1996 年 开始 ， 万 维 网 联盟 W3C (World Wide 
Web Consortium ) 开始 维护 HTML 文档 。2000 年 ，HTML 成 为 国际 标准 ， 标 准 号 ISO/IEC 
15445:2000)。HTML 4.0.1 是 HTML 发 展 过 程 中 一 个 里 程 碑 式 的 版 本 ， 它 发 布 于 1999 年 。 
2004 年 Web 超 文本 应 用 技术 工作 组 ( Web Hypertext Application Technology Working Group， 
WHATWG) 开始 编写 HTML 5 并 于 2014 年 完成 标准 的 制定 。 

HTML 5 作为 最 新 的 HTML 规范 ， 是 将 来 桌面 浏览 器 以 及 移动 浏览 器 的 发 展 趋势 ， 除 特 
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殊 说 明 外 ， 本 书 的 所 有 内 容 均 基于 HTML 5。 


DA HTML 编辑 器 


HTML 文档 的 本 质 是 文本 文件 ， 所 以 可 以 使 用 任何 文本 编辑 器 开发 。 虽 然 很 多 高 级 开发 
工具 也 可 以 用 来 编写 HTML 文档 ,但 是 这 些 工具 通常 会 提供 很 强大 的 代码 感知 、 自 动 补 全 
等 功能 ， 这 不 利于 初学 者 牢记 HTML 代码 ， 所 以 笔者 强烈 建议 初学 者 使 用 文本 编辑 器 进行 
HTML 开发 。 

Windows 系统 自 带 的 记事 本 工具 就 可 以 用 来 进行 HTML 开发 ， 在 编写 完 HTML 文档 后 ， 
将 文档 另存 为 .htm 或 者 .html 为 扩展 名 的 文件 即 可 。 这 两 种 文档 扩展 名 在 使 用 上 没有 任何 区 
别 ，.htm 是 早期 DOS 系统 的 扩展 名 ， 当 时 的 操作 系统 只 支持 3 位 扩展 名 ， 随 着 计算 机 技术 
的 发 展 ， 现 在 的 文件 扩展 名 已 经 没有 限制 了 。 虽 然 记 事 本 工具 能 够 加 深 初学 者 对 HTML 代码 
的 记忆 ， 但 是 由 于 记事 本 功能 简单 ， 连 最 基本 的 代码 高 亮 显 示 功 能 都 没有 ， 所 以 还 是 推荐 其 
他 工具 开发 HTML 文档 。 下 面 介绍 比较 受 欢 迎 的 两 个 HTML 开发 工具 。 


9.2.1 Notepad++ 


下 载 地 址 : https://notepad-plus-plus.org/。 
优势 : 语法 高 亮度 显示 、 代 码 折 欠 功能 、 代 码 自动 补 全 、 插 件 丰富 、 免 费 使 用 。 
软件 执行 界面 如 图 9-1 所 示 。 


[f Django BookHTMUdemohtml - Notepad: + 
XHA SAO 搜索 (S) 视图 (V) SAN ESU HAM IAO) XRM) GEG(R) HHHP) 
gaw ? 


i- iaminn mama —À a an E ERA 
CLE 4Tibiacim'w s sii v " 


9.2.2 Sublime Text 


下 载 地 址 : http://www.sublimetext.com/. 
优势 : 语法 高 亮度 显示 、 代 码 折 区 功能 、 代 码 自 动 补 全 、 插 件 丰 富 、 免 费 试用 。 
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软件 执行 界面 如 图 9-2 所 示 。 


El 59 :2TML HTML hem (HTM - Sublime Test (UNREGISTERED: - ü x 
He Edi Selecion Fnd View 
ros 


"m nu 
Dy Mae 
o FINCAS 


图 9-2 


DE HTML 结构 


打开 记事 本 工具 ， 在 其 中 输入 下 面 的 代码 : 


<!Doctype html» 
<html> 
<head> 
<meta charset="utf-8" /> 
<title>HTML 介 绍 </title> 
«/head» 


«body» 
网 页 内 容 

10 </body> 

11 

12 «/ntml» 


mwamuwhuwnmhP 


we 等 


将 此 文件 另存 为 demo.html， 右 击 文件 ， 选 择 打开 方式 (如 IE, Chrome, 18800 265 
如 果 已 经 将 .html 类 型 文件 关联 到 浏览 器 则 直接 双击 打开 文件 。 此 时 浏览 器 显示 如 图 9-3 所 示 。 


mm Fe 
| C [© tile///D/Djenccse20Book/demo html 


网 页 内 容 


页 的 body 坟 分 


图 9-3 
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代码 解释 : 
网 页 第 一 行 代码 <!Doctype html> 是 文档 类 型 声明 ， 用 于 指定 文档 类 型 ， 方 便 浏 览 器 对 
文档 进行 解释 并 泻 染 。 
<html> 标签 是 文档 的 根 节点 ， 告 诉 浏览 器 自身 是 一 个 HTML 文档 ， 其 他 所 有 HTML 标 
都 应 该 放置 在 <html> 标签 内 部 。 

<head> 标签 定义 文档 头 部 ， 在 <head> 标签 内 部 可 以 引用 脚本 、 样 式 表 、HTML 元 信 


息 等 。 
«meta» 标签 可 以 提供 页 面 的 元 信息 ， 本 例 中 使 用 <meta> 标签 规定 了 当前 文档 所 使 用 的 
字符 集 为 UTF-8 字符 集 。 


<title> 文档 标题 ， 具 体 使 用 效果 见 图 9-3。 
<body> 标签 包含 页 面 的 所 有 主体 内 容 如 文本 、 超 链接 、 图 片 、 视 频 、 音 频 等 。 


EZ] HTML 元 素 


HTML 作为 一 个 标记 语言 ， 定 义 了 很 多 标签 (tag)， 一 个 完整 的 HTML 文档 就 是 由 多 个 
标签 组 成 的 。 大 多 数 HTML 标签 都 是 成 对 出 现 的 ， 如 标题 标签 是 由 开始 标签 <title> 和 结束 
标签 </title> 组 成 的 ， 另 外 标签 之 间 还 可 以 骨 套 使 用 ， 不 过 需要 注意 的 是 ， 标 签 不 能 够 交叉 
舱 套 ， 即 子 标 签 的 结束 标签 必须 在 父 标 签 结束 标签 之 前 出 现 ， 和 否则 会 在 浏览 器 中 出 现 意 外 

本 节 将 选择 一 些 比较 常用 的 HTML 标签 进行 讲解 。 


9.4.1 属性 


在 介绍 HTMI 元 素 之 前 ， 先 了 解 一 个 概念 : 属性 。 
属性 可 以 赋予 HTML 元 素 更 多 的 信息 ， 如 可 以 给 元 素 添加 id 属性 用 于 唯一 标识 当前 
下 面 是 部 分 HTML 标签 的 全 局 属性 ， 可 以 应 用 于 所 有 HTML 元 素 。 


= 


1. accesskey 
描述 : 规定 了 激活 元 素 的 快捷 键 (Alt + accesskey) - 
示例 : 


«a href-"http://www.w3school.com.cn/html/" accesskey="h">HTML</a> 
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2. class 

描述 : 给 元 素 添加 一 个 或 多 个 样式 表 类 名 ， 当 存在 多 个 类 时 ， 类 名 之 间 使 用 空格 分 隔 。 
示例 如 图 9-4 所 示 。 

显示 效果 如 图 9-5 所 示 。 


2| head) 

3| neta charsetz"gb2312" /> 

4| Gtyle type="text/css"> 

5| header [text-align:center; font:bold 24px arial, sans-serif;} 
6| style» 

T| </head> 

8 


9| body> 

10 4p class="header ORERE 
11| body? 

12 


13| ht» 


图 9-4 


3. contenteditable 


描述 : 一 段 可 以 编辑 的 段落 ， 这 也 是 目前 绝 大 多 数 所 见 即 所 得 在 线 编辑 器 的 最 终 实现 原理 。 


显示 效果 如 图 9-6 所 示 。 


4. dir 
描述 ; 指定 元 素 内容 的 文字 方向 。 
语法 : 


示例 : 


显示 效果 如 图 9-7 所 示 。 

5. id 

描述 : 规定 了 HTML 元 素 的 唯一 标记 ,方便 JavaScript 等 脚本 语言 定位 元 素 。 
示例 : 
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图 9-6 图 9-7 


6. lang 
描述 : 规定 了 元 素 内 容 所 使 用 的 语言 。HTML 支持 的 语言 参考 附录 。 
语法 : 


示例 : 


7. style 
描述 : 规定 了 元 素 的 行内 样式 inline style). 
语法 : 


示例 : 


1| <!DOCTYPE html> 
2| <html> 


3 

4| <body> 

5 <p style-"color:blue; text-align: center ; “> 这 是 标题 </p> 
6 <p style="color :red PE XC PED» 

7| </body> 


8 
9| </html> 
10 


显示 效果 如 图 9-8 所 示 。 


8. tabindex 
描述 : 规定 了 使 用 Tab 键 选择 元 素 的 顺序 。 
语法 : 
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注 : 数字 1 表示 当前 元 素 是 第 一 个 元 素 。 

9. title 

描述 : 用 于 显示 元 素 的 额外 信息 ， 当 把 鼠标 悬 停 于 元 素 上 时 会 显示 一 段 文字 信息 。 
语法 : 


示例 : 
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9-8 9-9 
9.4.2 ”注释 标签 <!--.…--> 


与 其 他 编程 语言 一 样 ，HTML 代码 也 需要 有 注释 功能 ， 在 HTML 的 注释 标签 内 书写 的 
内 容 将 不 会 呈现 在 网 页 上 ， 如 : 


浏览 器 支持 如 图 9-10 所 示 。 


i 
f 
1 


ee 000 


图 9-10 
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9.4.3 ”文档 类 型 声明 标签 <IDOCTYPE> 


通过 前 面 的 HTML 介绍 ， 我 们 知道 在 HTML 的 发 展 过 程 中 出 现 过 很 多 版 本 ， 每 个 版 本 
之 间 都 会 存在 一 定 的 差异 ， 为 了 使 浏览 器 能 够 正确 识别 并 泻 染 当前 的 HTML 文档 ， 需 要 在 
HTML 文档 中 对 其 所 使 用 的 规范 进行 声明 。 

在 文档 类 型 声明 中 需要 指定 当前 文档 所 使 用 的 文档 类 型 定义 (DTD)， 文 档 类 型 声明 的 目 
的 就 是 使 SGML 工具 能 够 按照 DTD 的 规范 转换 和 验证 HTML 文档 。DTD 中 包含 了 允许 和 
禁止 的 文档 内 容 。 

DOCTTYPE 标签 有 以 下 特性 : 

O 不 是 HTML 标签 ， 不 需要 闭合 。 

口 必须 位 于 文档 第 一 行 。 

口 大 小 写 不 敏感 。 

O 所 有 浏览 器 都 支持 <IDOCTYPE>。 

下 面 是 几 个 重要 HTML 版 本 的 文档 类 型 声明 。 


1. HTML 5 


HTML 5 规范 的 一 个 重要 目标 就 是 简化 代码 ， 同 时 HTML 5 不 是 基于 SGML 开发 的 ， 因 
此 握 弃 了 早期 复杂 的 文档 类 型 声明 方式 ， 只 要 在 HTML 文档 开头 书写 <!DOCTYPE html> 浏 
览 器 就 可 以 将 文档 识别 为 HTML 5 规范 。 


2. HTML 4.0.1 Strict 


声明 当前 文档 使 用 超 文本 严格 文档 类 型 定义 ， 排 除了 显示 性 属性 和 已 经 弃 用 的 元 素 ， 
HTML 4.0.1 Strict 推荐 使 用 样式 表 代替 原 有 的 显示 性 属性 ， 同 时 不 允许 使 用 框架 (framesets)。 
下 面 是 DTD 声明 : 
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3. HTML 4.01 Transitional 


声明 当前 文档 使 用 超 文本 过 渡 类 型 定义 ,文档 支持 显示 性 属性 和 可 以 使 用 样式 表 替 代 的 
元 素 ， 但 不 允许 使 用 框架 。 
下 面 是 DTD 声明 : 


$92 Hmm 81 |E 


4. HTML 4.01 Frameset 


声明 当前 文档 使 用 超 文本 框架 集 类 型 定义 ， 与 HTML 4.01 Transitional 相同 ， 但 是 允许 
使 用 框架 。 
下 面 是 DTD 声明 : 


944 超 链 接 <a> 


描述 : 网 页 的 超 链接 允许 我 们 从 一 个 网 页 导航 到 另 一 个 网 页 或 者 锚 位置 。 
示例 : 
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浏览 器 支持 如 图 9-11 所 示 。 


IE Firefox Chrome Safari 
e e Ç 
图 9-11 


属性 及 值 如 表 9-1 所 示 。 


O blank 
Q parent 
Q self 
Q top 


target 


9.4.5 iH «button» 


Ho x 
规定 了 指向 的 页 面 地 址 


规定 了 打开 新 页 面 的 位 置 


描述 : 定义 一 个 按钮 。 与 另外 一 种 按钮 元 素 <input type="button"> 相 比 ，<button> 元 素 


更 为 强大 ， 在 标签 之 间 可 以 放置 任何 内 容 ， 如 图 片 。 
示例 : 


<button type="button"> 确定 </button> 


浏览 器 支持 如 图 9-12 所 示 。 


IE Firefox Chrome Safari 
= 
EO evo o0 
图 9-12 
属性 及 值 如 表 9-2 所 示 。 
表 9-2 


Opera 


O 


disabled disabled HE 


按钮 的 禁用 状态 


name 


文本 


规定 按钮 的 名 字 
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续 表 
属 性 Ho g 
type 规定 按钮 的 类 型 
value 规定 按钮 的 初始 值 ， 可 以 使 用 脚本 修改 


9.4.8 «div» 容器 
描述 : 用 于 定义 文档 中 独立 的 内 容 。<div> 是 一 个 块 级 元 素 ， 它 会 自动 开始 一 个 新 行 。 
示例 : 
«div style-"color:£00FF00;background-color:red;"» 这 是 一 个 div 标签 </divV> 


浏览 器 支持 如 图 9-13 所 示 。 


IE Firefox Chrome Safari Opera 
e oa OO @ 0 
图 9-13 


显示 效果 如 图 9-14 所 示 。 


f D) demohmi - xw 


| C [O fie///DyDjango%20Book/demohtml sr) : 


图 9-14 
9.4.7 标题 <h1>…<h6> 
描述 : 规定 了 网 页 主体 或 段落 的 标题 ， 从 大 到 小 分 别 用 标签 <hl> 至 <h6> 表示 。 
示例 : 
«hl» 这 是 一 级 标题 </h1> 


<h2> 这 是 二 级 标题 </h2> 
<h3> 这 是 三 级 标题 </h3> 


ss | 
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浏览 器 支持 如 图 9-15 所 示 。 


IE Firefox Chrome Safari Opera 
* q— 
e e Ç 
图 9-15 


显示 效果 如 图 9-16 所 示 。 


ee 
j D demohtm x 十 ge 


Q OG fis///D/Django'S20Bcok/demo.html xli 
a = 
这 是 一 级 标题 
这 是 二 级 标题 
这 是 三 级 标题 


图 9-16 
9.4.8 图 像 <img> 


描述 : 图 像 标签 用 于 向 网 页 中 嵌入 一 张 图 片 。 
示例 : 
<img src-"html5.png" width-"120" height-"auto" /> 


浏览 器 支持 如 图 9-17 所 示 。 


IE Firefox Chrome Safari Opera 
e e 9 @ 0 
图 9-17 
属性 及 值 如 表 9-3 所 示 。 
m 性 dH x 
alt 规定 图 片 不 显示 时 的 蔡 代 文 本 
sre 规定 图 像 的 位 置 
height 像素 值 或 百分比 规定 图 像 的 高 度 
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m 性 fü dH x 
width 像素 值 或 百分比 规定 图 像 的 宽度 


显示 效果 如 图 9-18 所 示 。 


续 表 


€ > CŒ |© filey//D/Django%20Book/demo.htmi 


HTML 


9-18 


9.4.9 输入 标签 «input» 


描述 : 用 户 可 以 使 用 <input> 标签 在 其 中 输入 数据 。 通 常 <input> 标签 与 HTML 表单 元 
素 结合 使 用 ， 用 于 收集 用 户 输入 信息 。 

示例 : 

修改 demo.html 添加 以 下 内 容 : 


创建 一 个 空白 的 HTML 文件 ， 命 名 为 receive.html 并 放置 在 demo.html 的 统计 目录 中 。 
用 浏览 器 打开 demo.html 并 输入 以 下 信息 ， 如 图 9-19 所 示 。 


| < > € [O tie///D/Djangossz08ook/demo.ntmr 


HTML 教 程 


9-19 
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击 “提交 ”按钮 ， 结 果 如 图 9-20 所 示 。 


x & 
€ | fiie///D:/Django*£208o0k/recelve.mimf?name-HTMLzES&select-on&confim-f r| 3 


图 9-20 
注意 ， 在 demo.html 中 填写 的 信息 已 经 出 现在 receive.html 的 地 址 栏 。 这 些 信息 的 显示 
格式 为 url?keyl=valuel& key2=value2& key3=value3 ，key 就 是 在 demo.html 中 元 素 的 name， 
value 就 是 我 们 访问 demo.html 时 填写 的 信息 。 具 体 使 用 方式 会 在 后 面 HTML 表单 一 节 中 详 
细 介 绍 。 
浏览 器 支持 如 图 9-21 所 示 。 


IE Firefox Chrome Safari Opera 
e e v0 0 
图 9-21 
属性 及 值 如 表 9-4 Bron - 
表 9-4 


属 性 Ho x 


checked 规定 input 元 素 首次 加 载 时 应 该 被 选中 
disabled 规定 input 元 素 首次 加 载 时 应 该 被 禁用 
maxlength 数值 规定 输入 字段 中 可 以 接收 的 最 大 长 度 

name 规定 input 元 素 的 名 字 ， 表 单 提交 的 必需 值 
readonly 规定 输入 字段 为 只 读 

size 规定 输入 字段 的 宽度 


button 
checkbox 
规定 input 元 素 的 显示 类 型 
在 HTML 5 中 提供 了 更 多 的 类 型 支持 ， 如 color、 
type password date, datetime, email, tel 等 ， 但 是 由 于 不 同 浏览 
radio 器 厂商 的 支持 情况 不 同 ， 建 议 谨慎 使 用 这 些 新 类 型 


reset 
submit 
text 


value 文本 规定 input 元 素 的 值 
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9.4.10 RŽ «p» 
描述 : 定义 段落 ，<p> 标签 内 容 会 自动 横向 铺 满 全 屏 ， 不 足 部 分 以 空白 填充 。 
示例 : 
«p style-"color:white;background-color:black; "> 这 是 一 段 文字 。</p> 


浏览 器 支持 如 图 9-22 所 示 。 


IE Firefox Chrome Safari Opera 
e e c00 
图 9-22 


显示 效果 如 图 9-23 所 示 。 


, Amm ir 
/ D) demo.html x 


Q © file///D./Diango9620Book/demo.html 


图 9-23 


9.4.11 «span» 标签 


描述 : 用 于 定义 行内 元 素 ， 以 便 通 过 样式 表 对 其 内 容 进 行 特殊 处 理 ， 正 常情 况 下 ， 
«span» 元 素 中 的 文本 与 其 他 文本 没有 任何 差异 。 
示例 : 


<p> 这 是 一 个 <span style="color:white;background-color:black;">span</span> 标签 </p> 
浏览 器 支持 如 图 9-24 所 示 。 


IE Firefox Chrome Safari Opera 


e e OO @ 0 


图 9-24 
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显示 效果 如 图 9-25 所 示 。 


Es— Bes 


图 9-25 


9.4.12 表格 «table» 


T 


描述 : <table> 是 一 个 比较 复杂 的 标签 ， 用 于 定义 一 个 HTML 表格 。 与 其 他 表格 一 样 ， 
HTML 表格 可 以 使 用 <caption> 子 标签 表示 表格 标题 ，<thead> 子 标签 表示 表 头 <tr> 子 标签 
表示 行 ，<td> 子 标签 表示 列 ，<tfoot> 子 标签 表示 表格 的 页 脚 。 注 意 ， 对 于 表 头 中 的 单元 格 
一 般 使 用 <th> 标签 表示 ，<th> 标签 通常 会 以 粗 体 居 中 的 形式 显示 文本 内 容 。 

示例 如 图 9-26 所 示 。 


1| «!DOCTYPE htnl 
2| <html> 

3 

4| <body> 

5 <table style-"border-style:solid;"» 
6 《capt ior> 

T 人 员 信 息 

8 <caption 

9 <thead> 

10 <tr> 

11 Colt cto 

12 <th) 年 龄 Vth> 

13 tr 

u </thead> 

15 <tbody> 

16 <tr> 

17 <td2Tamcytd> 

18 <td>18</t 中 

19 tp 

20 <tr> 

21 dJackyC td» 
22 <td>19</t 几 

23 t 

24 </tbody> 

25 <tfoot> 

26 <tr) 

27 <td>2018. 1. 1</t 中 
28 <td> 人 员 信 息 </t 中 
29 tr» 

30 €/tfoot? 

31 </table> 

32| </body> 

33 

34| </html> 

35 


9-26 


浏览 器 支持 如 图 9-27 所 示 。 


IE Firefox Chrome 
qq 
e e € 
图 9-27 
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Safari Opera 


e o 


属性 : 表格 标签 的 每 一 部 分 都 有 自己 的 属性 ， 常 用 的 属性 如 表 9-5 所 示 。 


表 9-5 
CE 
border 像素 值 
cellpadding 像素 值 或 百分比 
table 
cellspacing 像素 值 或 百分比 
width 像素 值 或 百分比 


Hx 
规定 表格 边框 的 宽度 
规定 表格 单元 格 边框 与 内 容 之 间 的 距离 
规定 单元 格 与 单元 格 之 间 的 距离 
规定 表格 的 宽度 


right 
left 

align center 内 容 的 水 平 对 齐 方式 
justify 

tr char 

top 

valign in 内 容 的 垂直 对 齐 方式 
bottom 
baseline 
right 
left 

align center 内 容 的 水 平 对 齐 方式 
justify 
char 

td top 

valign D 内 容 的 垂直 对 齐 方式 
bottom 
baseline 

colspan 数值 规定 单元 格 横 跨 的 列 数 

rowspan 数值 规定 单元 格 纵向 占有 的 行 数 
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显示 效果 如 图 9-28 所 示 。 


图 9-28 


9.4.13 ”列表 标签 <ol>、<ul>、<li> 


HE: <o> 用 来 定义 一 个 有 序列 表 ，<ul> 用 来 定义 一 个 无 序列 表 ，<li> 定义 列表 项 。 
示例 : 


浏览 器 支持 如 图 9-29 所 示 。 


显示 效果 如 图 9-30 所 示 。 


C | fileV//DyDijango%20Bookwdemo html tj: 


有 序列 表 : 


1. Python 

2. HTML 

3. JavaScript 
4. MySQL 

5. Django 


无 序列 表 : 


* Python 
* HTML 
* JavaScript 
e MySQL 
* Django 


属性 及 值 如 表 9-6 所 示 。 
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ik: 虽然 <ul> 和 <li> 元 素 也 支持 type 属性 ,但 是 在 HTML 中 推荐 使 用 样式 表 取 代 它 。 


表单 <form> 


虽然 表单 元 素 仍然 是 HTML 标签 的 一 种 ， 但 是 不 同 于 其 他 元 素 ， 


表单 元 素 提供 了 浏 


览 器 端 与 服务 器 端 交互 的 功能 ， 是 动态 网 站 的 重要 实现 手段 ， 所 以 在 本 节 对 其 进行 单独 


介绍 。 


表单 元 素 规定 了 一 个 区 域 ， 在 区 域内 用 户 输入 的 信息 可 以 被 收集 并 提交 到 服务 器 端 进行 


处 理 ， 通 过 表单 元 素 ， 用 户 能 够 对 服务 器 端 数据 进行 增 、 " de 查 操作 。 
表单 元 素 指 的 是 不 同类 型 的 input 元 素 ， 如 文本 框 、 单 选 框 、 复 选 


先 框 、 文 件 上 传 按钮 


等 。 表 单 提 交 一 般 通 过 提交 按钮 完成 ， 如 <input type="submit" name-"confirm" value= 


提交 LEN 
以 下 面 表单 为 例 进行 详细 介绍 。 
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1| <html> 
2| <body> 
3 
4| <form target="_blank" method="get" action="receive. html"> 
5 <input type="text" name="name" ><br» 
6 <input type-" checkbox" name=" select"><br> 
7 <input type="submit” name-"confirn" value=" jf3" ><br> 
8| </form> 
9 

10 | </body> 

11| </html> 

表单 属性 如 下 。 


Action: 规定 了 表单 提交 后 ， 服 务 器 端的 处 理 程序 位 置 。 


Method : 


规定 了 提交 表单 时 所 使 用 的 HTTP 方法 ， 可 选 值 有 get、post 等 。 如 前 面 例子 


所 示 的 get 方法 会 在 地 址 栏 中 显示 用 户 提交 信息 ， 而 post 方 法 会 随 着 http 消息 主体 中 发 送 不 
被 显示 ， 由 此 可 见 post 方 法 相对 安全 一 些 。get 与 post 方法 的 详细 比较 见 表 9-7。 
Target: 规定 了 action 属性 中 的 目标 地 址 ， 与 超 链 接 的 target 相似 ， 默 认 是 self. 


表单 元 素 
然 在 HTML 5 


: 表单 元 素 以 «form» 开始 、</form> 结束 ， 表 单元 素 通常 放置 在 表单 内 部 ， 虽 
中 可 以 在 表单 外 部 声明 表单 元 素 ， 如 下 面 代码 ， 但 是 这 样 通常 会 破坏 代码 结 


构 ， 不 利于 初学 者 理解 ， 所 以 编者 建议 将 所 有 表单 元 素 放置 在 表单 内 部 。 


<html> 
<body> 


<form 


id-"formName"|target-" blank" method="get” action="receive. html“> 


1 
2 
3 
4 
5 
6 
Ts 
8| «input 
9 

0 

1 


</html 


</form> 


<input type="checkbox” name-"select"54br? 
<input type="submit" name-"confirm" value=" f3" ><br> 


type="text” name="name" |form="formName“þ<br> 


</body> 


> 


另外 需要 注意 的 是 ， 表 单元 素 必 须 具 有 name 属性 ， 否 则 不 会 被 提交 到 服务 器 端 。 


表 9-7 
选 m GET POST 
后 退 /刷新 无 害 ee (浏览 器 应 该 告知 用 户 数据 
书签 可 收藏 为 书签 不 可 收藏 为 书签 
缓存 能 被 缓存 不 能 缓存 
application/x-www-form-urlencoded 或 
编码 类 型 application/x-www-form-urlencoded multipart/form-data。 为 二 进 制 数据 使 用 多 重 


历史 


编码 
参数 不 会 保存 在 浏览 器 历史 中 


参数 保留 在 浏览 器 历史 中 


据 类 型 的 
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HTTP 协议 本 身 不 对 URL 长 度 进行 限制 , 但 


是 不 同 Web 服务 器 与 浏览 器 对 URL 的 长 度 限 
制 不 相同 ， 如 正 允许 的 最 大 URL 字符 数 是 
2083 


只 允许 ASCII 字符 没有 限制 ， 也 允许 二 进 制 数据 


与 post 相 比 ，get 的 安全 性 较 差 ， 因 为 所 发 送 

的 数据 是 url 的 一 部 分 post 比 get 更 安全 ， 因 为 参数 不 会 被 保存 在 浏 
在 发 送 密码 或 其 他 敏感 信息 时 绝 不 要 使 用 get | 览 器 历史 或 Web 服务 器 日 志 中 

方法 


可 见 性 


数据 在 URL 中 对 所 有 人 都 是 可 见 的 数据 不 会 显示 在 URL 中 


第 10 章 
CSS 基础 


HTML 只 负责 绘制 网 页 结构 ， 如 果 想 要 开发 出 炫 酷 的 网 页 效果 的 话 ， 就 需要 使 用 CSS 
T, CSS 全 称 Cascading Style Sheets， 中 文 名 为 层 释 样式 表 ， 可 以 用 来 设置 HTML 元 素 的 样 
式 ， 如 果 结合 脚本 语言 还 可 以 动态 改变 HTML 元 素 样式 。 

在 CSS 没有 出 现 之 前 ,为 了 实现 一 些 简 单 的 效果 往往 需要 制作 大 量 的 图 片 ， 现 在 通过 使 
用 css 可 以 节省 很 多 工作 量 ， 提 高 工作 效率 。 目 前 最 新 的 CSS 版 本 是 CSS3 ， 除 特殊 说 明 外 
本 书 所 涉及 内 容 均 基 于 CSS3。 


EH araw 


在 深入 学 习 CSS 之 前 ， 先 来 了 解 一 下 盒子 模型 ( Box Model)。 所 有 的 HTML 元 素 都 可 
以 看 作 是 盒子 ， 这 个 盒子 是 一 个 矩形 ，CSS 可 以 对 称 形 的 每 一 个 部 分 进行 精准 设置 。 现 代 
浏览 器 都 可 以 辅助 开发 人 员 查 看 元 素 的 盒子 模型 ， 以 IE 为 例 ， 查 看 百度 搜索 框 的 盒子 模型 。 
打开 下 浏览 器 ， 跳 转 到 百度 首页 ， 按 下 快捷 键 F12 或 者 选择 “设置 ”一 “F12 开发 人 员工 具 ” 
打开 开发 人 员工 具 。 按 照 以 下 步骤 找到 搜索 框 的 盒子 模型 : 

(1) 选择 “DOM 资源 管理 器 ”。 

(2) 单 击 “ 选 择 元 素 ”按钮 。 

(3 ) 单 击 搜索 框 (此 时 鼠标 周围 会 出 现 横 纵 线条 ， 如 图 10-1 所 示 )。 

(A) 单 击 “ 布 局 ”标签 页 。 

具体 的 操作 步骤 见 图 10-1。 
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和 pba eo 


ele 


assets ipt" idema” reclergtha"ISi" weconpl d 
"auickseiete" ior"avickselete" styiec topi 9px; rignt: 9px; Giselay: nones™ wrese-davascriptiicot/ 


E 
pm). I | 


图 10-1 
现在 已 经 找到 了 搜索 框 的 盒子 模型 ， 放 大 查看 ， 如 图 10-2 所 示 。 


Offset 


6 
Margin 6 
e 


术语 翻译 : 

O Offset: 元 素 轮廓 的 偏 移 量 。 
口 Margin: 外 边 距 。 

口 Border: 边框 。 
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O Padding: 内 边 距 。 


从 图 10-2 可 以 看 到 ， 一 个 简单 的 HTML 元 素 其 实 是 由 很 多 复杂 的 盒子 组 成 的 ， 理 解 了 


这 个 盒子 模型 才 可 以 更 好 地 排版 


网 页 元 素 并 进行 像素 级 设置 。 


从 图 10-2 可 以 看 出 ， 一 个 盒子 是 由 Offset, Margin, Border, Padding 以 及 最 中 心 的 
Content 组 成 的 。 再 进行 细 分 可 以 将 Margin、Border、Padding 分 为 上 下 左右 四 部 分 ， 以 
Border 为 例 ， 就 是 border-top border-bottom, border-left, border-right, CSS 可 以 分 别 对 这 


四 部 分 进行 设置 。 


非 标准 W3C 规范 的 IE 5 RITE 6 
度 ， 高 度 也 是 这 样 的 。 


另外 通常 所 说 的 元 素 的 width 和 height 分 别 是 盒子 模型 中 content 的 宽 与 高 。 但 是 对 于 


来 说 ， 元 素 的 宽度 还 应 该 加 上 Padding 的 宽度 和 Border 的 宽 


两 元 素 外 边 距 合并 问题 : 当 两 个 相 邻 的 元 素 都 设置 了 Margin 时 ， 它 们 的 外 边 距 会 发 生 
合并 ,合并 后 以 原来 较 大 的 元 素 的 外 边 距 为 新 的 外 边 距 。 例 如 ,元素 A 的 下 方 外 边 距 为 20 


像素 ， 元素 B 的 上 方 外 边 距 为 
于 20 像素， 如 图 10-3 所 示 。 


10 像素, 合并 后 A 的 margin-bottom 等 于 B 的 margin-top 等 


合并 之 前 合并 之 后 

| te oe et | | | 

| | | 

| | | 

| | | 
A | 内 容 区 域 | 内 容 区 域 | A 

| | | 

| | | 

| margin-bottom:20px | margin-bottom:20px l 

= 一 MASI mp C | 

| margin-top: 10px | 形成 一 个 外 边 距 | l 

| zs 

| 内 容 区 域 | 
B | 内 容 区 域 | | 

| | | 

| Ka ammo ammo aao aa ana a a a a aa 

| 

CESEN 


图 10-3 


ik: 元 素 的 背景 是 由 Content, Padding 和 Border 组 成 的 。 


DA 引用 Css 样式 


对 HTML 元 素 应 用 CSS 样式 的 方式 有 两 种 。 
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方式 一 ; 使 用 style 属性 直接 将 CSS 样式 应 用 在 HTML 元 素 上 ， 这 种 样式 表 叫 作 “ 内 联 
样式 (Inline style》”， 语 法 如 下 : 


Xelement style="propertyl: valuel; property2: value2 … propertyN: valueN" /> 
这 里 element 是 需要 设置 CSS 样式 的 HTML JCR, property 是 CSS 样式 属性 名 ，value 


是 样式 属性 值 。 
方式 二 : 在 HTML 元 素 外 部 声明 CSS 样式 并 应 用 在 元 素 上 ， 语 法 如 下 : 


selector ( propertyl: valuel; property2: value2 … propertyN: valueN ) 

selector 是 元 素 选择 器 ， 用 于 定位 元 素 ， 通 过 selector 可 以 找到 需要 应 用 CSS 样式 的 一 
个 或 多 个 HTML 元 素 ，property 是 CSS 样式 属性 名 ，value 是 样式 属性 值 。 

在 HTML 元 素 外 部 声明 CSS 样式 的 方式 准确 来 说 又 分 为 两 种 。 一 种 是 在 HTML 元 素 所 
在 文档 中 使 用 <style> 标签 的 方式 ， 这 种 样式 表 叫 作 “ 内 部 样式 表 ”( internal style sheet), All 
下 所 示 。 


html) 
Mead) 
meta charsetz"gb2312" /> 
<style typez"text/css") 
header {text-align center; font;bold 24px arial, sans-serif; } 
style> 
</head> 


body> 


4p class="header"> 这 是 段落 标题 hp> 


1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11| wbody> 
12 

13 


</html> 
另外 一 种 是 引用 外 部 .css 文件 的 方式 ， 这 种 方式 最 灵活 ， 也 可 以 最 大 程度 地 保证 代码 复 
用 ， 这 种 css 文件 叫 作 “外 部 样式 表 ”( external style sheet)， 下 面 是 w3school 使 用 外 部 样式 


表 的 例子 : 


JEE m 
2| html xmlns="http: //www. v3. org/ 1999/xhtnl”> 
3| head> 

4| ti tle)w3school 在 线 教程 人 title> 
5 rip nt 


mive"Content-Lenguage" content-"zh-cn" /> 
obots" content-^all" /> 

mthor" content-"w3school. com, cn" /> 
opyright" content-"Copyright W3school. com.cn All Rights Reserved." /> 
12| «nete nane-"HSSnartTagsPreventParsing" content="true” /> 

13| neta http-equiv-"inagetoolbar" content-"false" /> 

14| <link rel-icon type-"image/png" sizes="16x16" href-"/logo-16. png"? 

15| dink rel=icon type-"image/png" 
16| dink rel=icon typez"image/png" 
17| Qink re; m type-"image/png" 
18| Qink rel-"apple-touch-icon-preconposed" sizes- "96x96" href-"/logo-96 png? 
19| Qink rel-"apple-touch-icon-preconposed" sizes-^144xl44" href-"/logo-144. png^) 
20| (head? 
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CSS 优先 级 


F 一 个 元 素 时 ， 到 底 会 


前 面 讲 到 CSS 样式 表 可 以 有 三 种 定义 方式 ， 那 么 当 多 个 样式 作用 了 


使 用 哪个 样式 呢 ? 


的 档 


一 般 而 言 ， 所 有 的 样式 会 根据 下 面 的 顺序 县 加 于 一 个 元 素 之 上 ， 后 面 的 样式 会 覆盖 前 


EIÑ: 


口 浏览 器 缺 省 设置 。 

O 外 部 样式 表 (如 使 用 link 标签 引用 的 外 部 CSS 文件 )。 
口 内 部 样式 表 (如 位 于 <head> 标签 内 定义 的 样式 )。 

O 内 联 样式 (在 HTML 元 素 的 style 属性 中 定义 的 样式 )。 
由 此 可 见 ， 内 联 样式 的 优先 级 最 高 。 


E 


对 于 使 用 外 部 CSS 样式 的 情况 ， 选 择 器 至 关 重 要 ， 它 直接 决定 了 CSS 样式 将 会 被 应 用 
在 哪个 元 素 上 。 本 节 将 会 介绍 几 种 最 常见 的 选择 器 。 


10.4.1 ”元素 选择 器 


元 素 选 择 器 根据 HTMI 元 素 的 标签 名 来 定位 元 素 。 如 果 在 HTML 文档 中 同一 类 型 元 素 
出 现 多 次 ,那么 CSS 样式 将 会 应 用 在 所 有 元 素 上 。 


元 素 选 择 器 的 语法 如 下 : 


element { propertyl: valuel; property2: value2 … propertyN: 


下 面 例子 对 HTML 文档 中 所 有 «p» 元 素 设置 样式 : 


1| html> 

2| qhead> 

3| neta charset-"gb2312" /> 

4| 4style type="text/css"> 

5 p [text-align:center; font:bold 24px arial,sans-serif;] 
6| V style? 

了 | head? 

8 


11) pan span? 
12 名) 这 是 段落 标题 2 《</p> 
13| Ybody> 

14 


15| Yhtnl> 


显示 效果 如 图 10-4 所 示 。 


valueN } 
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rc—- + EE 


C €  Yrpsegmudmom am f> X d- + = 
这 是 段落 标题 1 
这 是 段落 标题 2 


图 10-4 


10.4.2 ID 选择 器 
ID 选择 器 以 HTML 元 素 的 ID 属性 来 确定 元 素 ，ID 选择 器 的 语法 如 下 : 


#ID ( propertyl: valuel; property2: value2 … propertyN: ValueN } 


下 面 例子 对 HTML 文档 中 ID 为 header 的 <p> 元 素 设置 样式 : 


1| html> 
2| dead 
3| meta charsetz"gb2312" /> 


4| (style type="text/css"> 
5| — fheader [text-align:center; font:bold 24px arial, sans-serif;] 


6 style? 

T| </head> 

8 

9| body> 

10 p id="header OR SEES AERE U^ 
11 Cspan span? 

12 名) 这 是 段落 主体 </p> 

13| Ybody> 


14 
15| Ghtnl> 
显示 效果 如 图 10-5 所 示 。 
E . Wheel 


C, C x mejmuydemohm Q f> X D- + 
这 是 段落 标题 


川 x 


这 是 段落 主体 


图 10-5 


10.4.3 ”类 选择 器 
长 选 择 器 以 HTML 元 素 的 类 属性 来 确定 元 素 ， 语 法 如 下 : 


… propertyN: valueN } 


.Class ( propertyl: valuel; property2: value2 


日 于 同一 个 元 素 可 以 包含 多 个 类 ， 不 同 的 元 素 可 以 包含 相同 类 ， 所 以 只 要 包含 指定 类 名 


H 
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的 元 素 都 会 应 用 相同 的 样式 。 
下 面 例 子 中 两 个 <p> 元 素 都 包含 header 类 ， 同 时 第 一 个 <p> 元 素 还 包含 另 一 个 类 
heaghtlight: 


html> 

head 

(neta charset-"gb2312" /> 

<style type="text/css"> 

„header [text-align:center; font:bold 24px arial, sans-serif;} 
heaghtlight { color: red;] 

style? 

</head> 


<p class="header heaahtliaht") 这 是 段落 标题 14 p> 
spar? /sp an? 

<p class="header VRE RSE p) 

</body> 


1 
2 
3 
4 
5 
6 
了 
8 
9 
10| body> 
11 
12 
13 
14 
15 
16 


html? 


显示 效果 如 图 10-6 所 示 。 


C (C O üegmydemomm Qm f> X D- + 
| 这 是 段落 标题 1 
| 这 是 段落 标题 2 
| 


10-6 


10.4.4 ”后 代 选 择 器 


后 代 选 择 器 可 以 选择 某 元 素 的 后 代 元 素 ， 语 法 如 下 : 
Selectorl selector2 ( propertyl: valuel; property2: value2 … propertyN: valueN } 


Selector2 是 selector! 的 后 代 节 点 。 
代码 如 下 : 


htnl> 

<head> 

<meta charset="gb2312" /> 

<style type="text/css"> 
p span [color:red;] 

style? 

head? 


1 

2 

3 

4 

5 

6 

7 

8 

9| body? 
10 《span) 这 个 span 元 素 不 是 p 元 素 的 子 节点 /span> 

1 qp) span)S elector24/span? 是 salecterl 的 后 代 节点 。</p> 
12| Ybody> 

13 

14 


html> 
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显示 效果 如 图 10-7 所 示 。 


< >) C (C) m üeumudemom as f> X -+ = 


x 


这 个 span 元 素 不 是 p 元 素 的 子 节点 
Selector2 是 selectorl 的 后 代 节点 。 


图 10-7 


10.4.5“ 子 元 素 选 择 器 


后 代 选 择 器 可 以 选择 某 元 素 的 所 有 后 代 元 素 ， 而 子 元 素 选择 器 只 能 查找 某 元 素 的 直接 子 
元 素 ， 语 法 如 下 : 


Selectorl > selector2 { propertyl: valuel; property2: Value2 … propertyN: valueN } 


Selector2 是 selectorl 的 子 节点 。 
代码 如 下 : 


1| html> 

2| «head? 

3| meta charsetz"gb2312" /> 

4| (style type="text/css"> 
p span [color:red;] 

6| style? 

7| «head» 

8 


9| body> 
10| — 4 spar/Selector24/span? Eselectori HJF HA o G) Gpan pan E TERNER TU span》 i p? 


11| </body> 
12 
13| Yhtnl> 


显示 效果 如 图 10-8 Brz o 


@ demohtml + E ESX 


C (C flepydemohim Qs f> X D- + = 
Selector2 féselectorl] FPA. df spar TUE ESESETTA 


图 10-8 
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E etapa 

有 时 需要 对 多 个 选择 器 进行 相同 的 样式 设置 ， 如 将 P、table、span 元 素 的 字体 颜色 都 设 
置 为 灰色 。 如 果 不 使 用 选择 器 分 组 ， 则 需要 分 别 设置 。 将 来 如 果 发 生 改 变 ， 也 需要 分 别 修 
改 ， 这 样 不 仅 工作 量 大 而 且 还 容易 造成 遗漏 ， 如 : 


7| p i color: grey; ] 
8| table [ color: grey;] 
9| span { color: grey; ] 


如 果 对 选择 器 进行 分 组 ， 可 以 大 大 减少 代码 量 ， 如 : 


2| 
7| p, table, span [ color: grey; ] 
el 


对 选择 器 进行 分 组 后 ， 不 影响 对 个 别 选择 器 进行 特殊 设置 ， 例 如 : 


1| Qtml> 
2| head) 

3| meta charsetz"gb2312" /> 

4| Gstyle type="text/css"> 

5 #header [ text-align: center; font: bold 24px arial; ] 

6 p span [color:red;] 

7 P span { color: grey; ] 

B 

9| style» 

10| Yhead> 

11 

12| body> 

13 <p id="header") 这 是 段落 标题 《4p> 

14| — @)Kspan2Selector2</span》 是 selectorl 的 子 节点 。<i>(span> 这 个 sp an 元 素 不 是 p 元 素 的 直接 子 节点 </ span》 i0? 
15 《span> 这 是 一 个 新 段落 </ span> 

16| </body> 

17 


18| </html> 


显示 效果 如 图 10-9 所 示 。 


| C € s oeg/bidemoMm Qss p» X D- += 


这 是 段落 标题 
Selector2 fÉselectoril] T DA» irf spat Er REEF BA 
这 是 一 个 新 段落 
图 10-9 


A css 颜色 值 


CSS 颜色 值 可 以 用 来 设置 HTML 元 素 的 背景 颜色 、 文 字 颜 色 等 一 切 可 以 显示 的 元 素颜 
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色 。CSS 支持 以 下 几 种 类 型 的 颜色 值 。 


10.6.1 十 六 进 制 色 


目前 所 有 主流 浏览 器 都 支持 十 六 进 制 颜色 值 ， 格 式 为 梳 RGGBB， 其 中 RR 表示 Red 
(红色 )、GG 表示 Green (绿色 )、BB 表示 Blue ( 蓝 色 )， 所 有 值 都 必须 是 介 于 0 和 FF 之 间 的 
十 六 进 制 值 。 例 如 : 黑色 是 4000000, diei #0000FF ， 黄 色 是 4FFFFO00. 

示例 : 


background-color:$ff0000; 


10.6.2 RGB 颜色 


目前 所 有 主流 浏览 器 都 支持 RGB 颜色 值 ， 格 式 为 : rgb(R, G, B)， 其 中 及 代表 红色 ，G 
代表 绿色 ，B 代表 蓝 色 ， 每 个 参数 定义 颜色 的 亮度 ， 可 以 是 0 和 255 之 间 的 整数 或 者 一 个 百 
分 比值 (从 0 到 100% 之 间 )。 

示例 : 


background-color:rgb(255,0,0); 


10.6.3 RGBA 颜色 


最 新 的 浏览 器 基本 都 支持 RGBA 颜色 ， 如 IE 9+, Firefox 3+, Chrome, Safari 以 及 
Opera 10+。 

RGBA 颜色 是 RGB 颜色 的 扩展 ， 带 有 一 个 alpha 通道 ， 它 规定 了 对 象 的 不 透明 度 ， 
RGBA 颜色 值 的 格式 为 : rgba(R, G, B, alpha), alpha 参数 是 介 于 0.0 (完全 透明 ) 与 1.0 (完全 
不 透明 ) 的 数字 。 

示例 : 


background-color:rgba(255,0,0,0.5); 


10.6.4 HSL 颜色 


HSL 颜色 也 得 到 了 大 多 数 浏览 器 的 支持 ， 如 IE 9+、Firefox、Chrome Safari 以 及 Opera 
10+, 
HSL 中 五指 的 是 色调 (hue), S 指 的 是 饱和 度 ( saturation)、 工 指 的 是 亮度 (lightness)。 
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HSL 颜色 值 的 格式 为 hsl(hue, saturation, lightness), hue 的 取 值 范围 是 0 ~ 360, 0 或 者 360 
代表 红色 ，120 是 绿色 ，240 是 蓝 色 。Saturation 是 百分比 值 , 0 代表 灰色 ，100% 代表 全 彩色 。 
Lightness 同样 是 百分比 值 ，0 代表 黑色 ，100% 代表 白色 。 


图 10-10 是 HSL 取 色 板 ， 方 便 读 者 理解 HSL 的 取 值 意义 : 随 着 hue 值 的 增加 ， 色 调 


也 会 从 12 点 钟 方向 开始 顺 时 针 旋 转 ， 逐 渐 从 红色 过 渡 到 绿色 ， 然 后 过 渡 到 蓝 色 ， 最 后 回 到 
红色 ; 随 着 Saturation 值 的 增加 ， 颜 色 会 逐渐 从 圆心 位 置 向 外 转移 ， 颜 色 越 来 越 鲜 艳 ， 而 
lightness 则 直接 影响 颜色 的 亮度 。 


RED(0°) 


MAGENTA(300°) YELLOW(60°) 


BLUE(240*)  GREEN(120*) 


CYAN(180?) 


图 10-10 
示例 : 


background-color: hsl(60, 100%, 50%); 


10.6.5 HSLA 颜色 


HSLA 颜色 是 HSL 颜色 的 扩展 ， 添 加 了 alpha 通道 ， 它 规定 了 对 象 的 不 透明 度 ，alpha 


的 取 值 范围 是 0.0 (完全 透明 ) 与 1.0 (完全 不 透明 ) 之 间 的 数字 。HSLA 颜色 在 最 新 的 浏览 器 


H 


Ph 得 到 了 支持 ， 如 IE 9+, Firefox, Chrome, Safari 以 及 Opera 10+, 


示例 : 


background-color:hsla (120, 65%,75%,0.3); 


10.6.6 MEX / 跨 浏览 器 颜色 名 


所 有 现代 浏览 器 都 支持 预定 义 颜色 ， 如 红色 的 预定 义 颜 色 名 为 rrd， 全 部 预定 义 颜色 可 
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参看 插页 。 


CSS 尺寸 单位 


就 像 数学 中 丈量 距离 时 需要 米 、 厘 米 、 英 尺 等 长 度 单位 一 样 ，CSS 中 度量 HTML 元 素 
尺寸 也 需要 单位 ，CSS 支持 几 种 不 同 的 长 度 表 达 方 式 ， 一 般 情况 下 ，CSS 长 度 以 数字 + 单位 
名 称 的 形式 表示 ， 数 字 与 单位 之 间 不 能 有 空格 ， 另 外 如 果 长 度 为 0 则 可 以 忽略 单位 。 

CSS 支持 两 种 长 度 单位 类 型 : 相对 长 度 和 绝对 长 度 。 


10.7.1 浏览 器 支持 情况 


表 10-1 中 的 数字 表示 支持 该 长 度 单位 的 最 低 浏 览 器 版 本 
表 10-1 


长 度 单位 
em, ex, %, px, cm, mm, in, pt, pc 
ch 
rem 
vh, vw 
vmin 


vmax 


需要 注意 的 是 ，IE 9 通过 不 标准 的 名 称 vm 来 支持 vmin 
10.7.2 ”相对 长 度 


相对 长 度 指定 了 一 个 相对 于 其 他 长 度 属性 的 长 度 ， 对 于 不 同 设备 来 说 ,使 用 相对 长 度 更 
合适 ， 如 表 10-2 所 示 。 


表 10-2 
单 位 Ho x 
em 指定 了 相对 于 当前 元 素 字体 尺寸 的 长 度 (例如 2em 表示 当前 字体 的 两 倍 长 度 ) 
ex 指定 了 相对 于 英文 字母 小 写 x 的 高 度 ( 极 少 使 用 ) 
ch 指定 了 相对 于 数字 0 的 宽度 
rem 指定 了 相对 于 根 元 素 (HTML) 的 字体 大 小 
vw 相对 于 当前 视窗 的 宽度 ，1vw= 视窗 宽度 的 1% 
vh 相对 于 当前 视窗 的 高 度 ，1vh= 视窗 高 度 的 196 
vmin vw fll vh 中 较 小 的 那个 
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$ 位 描 x 
vmax | vw 和 vh 中 较 大 的 那个 


相对 于 继承 的 font-size 的 长 度 ， 如 果 父 元 素 的 font-size 是 10em， 那 么 5096 就 是 5em，200% 就 
是 20em 


% 


需要 注意 的 是 ，rem 和 em 都 用 来 设置 相对 于 字体 的 大 小 ,但 是 rem 相对 的 是 HTML 根 
元 素 字体 的 大 小 ，em 相对 的 是 当前 元 素 的 大 小 。 


10.7.8 绝对 长 度 


绝对 长 度 单位 是 固定 的 ， 由 于 显示 器 存在 很 多 差异 ， 所 以 不 推荐 在 显示 器 上 使 用 绝对 长 
度 单位 ， 但 是 如 果 读 者 的 输出 设备 是 确定 的 ， 比 如 打印 机 ， 那 就 可 以 使 用 绝对 长 度 单位 ， 如 


表 10-3 所 示 。 
表 10-3 
单 位 描 述 

cm 厘米 

mm 毫米 

in 英寸 (lin=2.54cm) 

px* 像素 (计算 机 屏幕 上 的 一 个 点 ) 

pt 磅 ， 大 约 1/72 英寸 

pe 派 卡 ， 印 刷 字母 规格 和 字 行 长 度 单位 ， 大 约 6pt，1/6 英寸 

需要 注意 的 是 ,像素 (px) 是 相对 于 显示 设备 的 ， 对 于 低 分 辨 率 设备 ，1px 就 是 设备 上 
的 一 个 点 ， 但 是 对 于 高 分 辨 率 设备 来 说 ，1px 代表 多 个 点 。 


ETE] x 
前 面 介 绍 了 CSS 样式 的 基本 语法 以 及 CSS 样式 的 引用 方式 ， 在 本 节 将 会 学 习 如 何 使 用 
CSS 改变 HTML 元 素 样式 。 


10.8.1 背景 


CSS 从 以 下 几 方 面 设置 元 素 的 背景 。 
1. background-color 
描述 : 规定 HTML 元 素 背 景 颜色 。 
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属性 值 : 任意 CSS 颜色 。 

2. background-image 

IE: 将 图 像 设 置 为 元 素 背景 。 

属性 值 : url (图 片 地 址 )。 

3. background-repeat 

描述 : 规定 背景 图 像 是 否 重复 。 

属性 值 如 表 10-4 Bron o 

R 10-4 

属 性 值 描 x 
Repeat 默认 值 ， 背 景 图 片 SERR 方向 和 水 平方 向 重复 
repeat-x 背景 图 片 会 在 水 
repeat-y 背景 图 片 会 在 垂直 方向 重复 
no-repeat 背景 图 片 仅 显示 一 次 ， 不 重复 
inherit 从 父 元 素 继承 background-repeat 属性 的 设置 


4. ieu due 


描述 : 规定 背景 图 像 是 否 跟随 文档 滚动 。 
diii 10-5 所 示 。 


表 10-5 
属 性 值 Ho xk 
scroll 默认 值 ， 背 景 图片 会 跟随 文档 其 余部 分 而 滚动 
fixed 当 文 档 滚动 时 ， 背 景 图 片 不 会 滚动 
inherit 从 父 元 素 继承 background-attachment 属性 的 设置 


5. background-position 
描述 : 规定 背景 图 像 的 起 始 位 置 。 
属性 值 如 表 10-6 所 示 。 


表 10-6 

属 性 值 描 述 
left top 
left center 
left bottom 
right top 设置 背景 图 片 相对 于 元 素 的 位 置 ， 如 果 只 给 出 一 个 关键 字 则 另 一 个 值 为 center， 如 : 
Tight center (1 ) background-position: left; 等 价 于 background-position: left center; 
Tight bottom (2) background-position: center; 等 价 于 background-position: center center; 


center top 
center center 
center bottom 
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cd 
一 一 一 一 一 一 一 
E 性 fd Ji E 
第 一 个 值 是 水 平 位 置 ， 第 二 个 值 是 垂直 位 置 
x% y% 元 素 的 左上 角 是 0% 0%， 左 下 角 是 10096 10096 


如 果 只 给 出 一 个 值 ， 则 另 一 个 值 为 50% 


默认 值 是 0% 0% 
te or AGGREAAGAGSAGSSSRASSSSSSSSSSSSSSSSSSSSAASSSSSSSSSSSSEEEEEEE 


xpos ypos 


initial 
inherit 


第 一 个 值 是 水 平 位 置 ， 第 二 个 值 是 垂直 位 置 


元 素 的 左上 角 是 0 0。 单位 可 以 是 像素 (px) 或 者 其 他 任何 CSS 单位 


如 果 只 给 出 一 个 值 ， 则 另 一 个 值 为 50% 
可 以 将 % 和 其 他 位 置 混合 使 用 ， 如 : 


background-position:100px center; 


使 用 元 素 默 认 值 。 正 不 支持 该 属性 


从 父 元 素 继承 background- position 属性 的 设置 


6. background 


描述 : 规定 背景 图 像 的 起 始 位 置 。 
属性 值 : CSS 背景 属性 的 简写 形式 ， 可 在 一 行 代 码 中 声明 所 有 背景 属性 。 
示例 : background: #00FF00 url(background.gif) no-repeat fixed center; 


代码 示例 : 


T| htnl 
2 head> 


3| meta charsetz"gh2312" /> 
4| <style type="text/css"> 


"el 


background-image: url (ess. jpg): 
backer ound-r epeat ‘no-repeat 


hei ght :100px ; 


5 
6 

7 

8 backgr ound-posi ti on: center: 
9 

0 border: solid thin black; 
1 


17 div idc" be AE RAA AIDI V di v 


18| body: 
19 


20| tnl» 


浏览 器 显示 效果 如 图 10-11 所 示 。 


LE 


图 10-11 


第 10 章 “CSS 基础 109 | [RS 


10.8.2 文本 


1. 文本 颜色 

CSS 通过 color 属性 设置 文本 颜色 ， 可 选 属性 值 为 任意 CSS 颜色 。 

示例 : color:red; 

2， 文 本 对 齐 方式 

CSS 通过 text-align 属性 设置 文本 的 水 平 对 齐 方式 。 可 选 属性 值 : 左 对 齐 (left)、 右 对 齐 
(right), 居中 对 齐 (center)、 两 端 对 齐 (justified) . 

示例 : text-align:center; 

需要 注意 的 是 ，justified 不 会 处 理 被 打 断 的 行 和 最 后 一 行 ， 所 以 如 果 文 字 只 占 一 行 的 话 
justified 不 会 起 作用 ， 此 时 可 以 使 用 text-align-last 属性 蔡 代 text-align， 但 是 text-align-last 并 
不 支持 所 有 浏览 器 。 此 时 可 以 在 文本 最 后 一 行 添加 一 个 span 元 素 将 文本 撑 开 ， 例如: 


.center( 
text-align:justify; 
3 
span( 
display:inline-block; 
width:1005; 
J 
<p class="center"> 两 端 对 齐 文字 <span></span></p> 


3. 文本 修饰 
CSS 通过 text-decoration 属性 设置 或 删除 文本 的 装饰 。 
属性 值 如 表 10-7 所 示 。 


表 10-7 
属 性 值 描 x 
none 用 来 删除 链接 的 下 面 线 
overline 为 文本 添加 上 夯 线 


line-through 为 文本 添加 删除 线 


为 文本 添加 下 画 线 


underline 


4. 文本 转换 
CSS 通过 text-transform 属性 设置 文本 中 字母 的 大 小 写 。 
属性 值 如 表 10-8 所 示 。 
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表 10-8 
B E 值 描 述 
uppercase 设置 文本 中 的 字母 大 写 显示 
lowercase 设置 文本 中 的 字母 小 写 显示 
capitalize 设置 文本 中 的 单词 首 字母 大 写 显 示 
5. 文本 缩 进 


CSS 通过 text- indent 属性 设置 文本 首 行 缩 进 方式 。 
示例 : text-indent:50px; 

6. ft1& 

CSS 通过 line-height 属性 设置 文本 行 与 行 之 间 的 空白 
示例 : line-height:15096; 


10.8.3 边框 


前 面 讲 了 Css 盒子 模型 ， 其 中 边框 就 是 围绕 元 素 内 容 和 内 边 距 的 一 条 或 者 多 条 线 ，CSS 
的 border 属性 可 以 用 来 设置 边框 的 样式 、 宽 度 和 颜色 

若 针 对 某 一 条 边框 进行 设置 ，CSS 属性 格式 为 “border- 边框 - 样式 ”， 如 : border-top- 
style, CSS 一 共有 四 种 边框 : top, bottom, left, right 


1. 边框 样式 
CSS 通过 border-style 属性 设置 元 素 边框 的 显示 样式 ， 支 持 表 10-9 所 示 的 属性 值 。 
表 10-9 
属 性 值 描 x 
dotted 定义 点 状 边框 
dashed 定义 虚线 
solid 定义 实 线 
double 定义 双 实 线 
groove XE SL 3D 凹 槽 边框 ， 显 示 效 果 取决 于 border-color 
Tidge 定义 3D 垄 状 边框 ， 显 示 效 果 取 决 于 border-color 
inset 定义 3D inset 垄 状 边框 ， 显 示 效 果 取 决 于 border-color 
outset 定义 3D outset ŽRE, TRARIA F border-color 
none 规定 无 边框 状态 


hidden 隐藏 边框 
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2. 边框 宽度 
CSS 通过 border-width 属性 设置 元 素 边框 的 显示 宽度 ， 可 以 通过 单位 自 定义 宽度 ， 也 可 
以 使 用 CSS 预定 义 宽度 : thin, medium, thick. 


3. 边框 颜色 
CSS 通过 border-color 属性 设置 元 素 边框 的 颜色 。 边 框 支持 任意 CSS 颜色 ， 默认 情况 下 


使 用 元 素 自 身 的 颜色 。 


4. 边框 样式 的 设置 顺序 

CSS 允许 一 次 设置 所 有 边框 也 可 以 同时 设置 多 个 边框 ， 具 体 用 法 如 下 : 

口 如 果 只 给 出 一 个 属性 值 ， 样 式 会 应 用 到 全 部 边框 。 

口 如 果 给 出 两 个 属性 值 ， 第 一 个 值 会 应 用 到 上 下 两 条 边框 ， 第 二 个 值 会 应 用 到 左右 两 条 
边框 。 

口 如 果 给 出 三 个 属性 值 ， 第 一 个 值 会 应 用 到 上 边框 ， 第 二 个 值 会 应 用 到 左右 两 条 边框 ， 
第 三 个 值 会 应 用 到 下 边框 。 

O 如 果 给 出 四 个 属性 值 ， 则 四 个 值 会 分 别 应 用 到 上 、 右 、 下 、 左 四 条 边框 。 


示例 : 

1| html> 

2| head> 

3| (neta charset="gb2312" /> 

4| <style type="text/css"> 

5 #bzl [ 

6 border-color : red; 

Li border-style: dotted; 

8 } 

9 Fed 

10 border-color: red; 

1 border-style:dotted solid; 

12 } 

13 #be3 { 

14 border-color: red; 

15 border-style:dotted solid double; 

16 H 

17 *bei [ 

18 border-width: 10px ; 

19 border-color: red; 

20 border-style:dotted solid double groove; 
21 T 

22|4/style? 

23| Yhead> 

24 

25| body> 

26 <p id="bgl “border-style: dotted; </p> 

27 <p id-"bg2'Dborder-style:dotted solid; </p> 
28 <p id="bg3 “border-style: dotted solid double; </p> 
29 <p id="bg4">border-style:dotted solid double groove; </p> 
30 Ybody> 

31 

32| </html> 
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浏览 器 显示 效果 如 图 10-12 所 示 。 


> C lU 安 flel//Dydemohim Qs% p» 三 - 0 X 


demo.html ME © demo.html — 


本 生硬 和 本 
rder-style:dotted solid double groove; 
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JavaScript 是 现代 Web 应 用 程序 的 灵魂 ， 已 经 被 所 有 浏览 器 所 支持 。 随 着 前 端 技 术 的 发 
展 ，JavaScript 的 地 位 也 在 逐渐 提高 ,已 经 有 了 替代 其 他 Web 开发 语言 的 潜力 。 当 前 比较 流 
行 的 Web 开发 框架 如 AngularJS, 、React、Node.js， 都 是 基于 JavaScript 语言 开发 的 。 本 章 将 
会 介绍 JavaScript 的 基本 概念 与 Web 应 用 技术 基础 。 


EKI JavaScript 介绍 


JavaScript 的 前 身 是 网 景 公 司 开发 的 LiveScript 语言 ， 由 于 早期 的 Web 应 用 只 能 展示 一 
些 静 态 内 容 ， 严 重 限制 了 用 户 体验 ， 因 此 为 了 提高 网 页 的 交互 性 网 景 公司 开发 了 LiveScript 
语言 。 后 来 网 景 公司 与 Sun 公司 合作 改进 并 重新 设计 了 LiveScript 语言 ， 由 于 当时 Java 语言 
正如 日 中 天 ， 网 景 公 司 和 Sun 公司 都 希望 新 语言 能 够 借助 Java 流行 起 来 ， 所 以 将 新 语言 命名 
为 JavaScript. 

由 于 JavaScript 是 一 门 脚本 语言 ， 因 此 可 以 使 用 任何 文本 编辑 器 开发 它 ， 如 Notepad++。 


EXE 在 HTML 中 使 用 JavaScript 


一 般 在 HTML 文档 中 有 以 下 三 种 方式 使 用 JavaScript。 

D 在 网 页 中 使 用 <script> 标签 的 方式 插入 JavaScript 脚本 。 
O 直接 在 HTML 元 素 标签 中 嵌入 JavaScript。 

口 引入 外 部 JavaScript 脚本 文件 。 


11.2.4. 在 网 页 中 使 用 <script> 标签 


在 网 页 中 使 用 <script> 标签 插入 JavaScript 的 方式 又 可 以 根据 <script> 标签 所 在 位 置 分 
为 在 «head» 中 使 用 JavaScript 和 在 <body> 中 使 用 JavaScript。 这 两 种 方式 在 代码 书写 方面 没 
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有 区 别 ， 但 是 在 网 页 被 访问 时 ，JavaScript 的 执行 会 出 现 一 些 差异 ， 这 些 差异 可 能 会 导致 网 
页 出 现 不 可 预期 的 错误 。 

下 面 是 两 种 引入 JavaScript 的 代码 示例 。 

在 <head> 中 搬入 JavaScript，demol.html: 


在 <body> 中 插入 JavaScript, demo2.html: 


以 上 两 个 代码 示例 都 希望 在 网 页 中 分 别 显 示 一 个 标题 和 一 个 段落 。 

用 浏览 器 打开 demol.html 文件 ， 如 图 11-1 所 示 。 

用 浏览 器 打开 demo2.html 文件 ， 如 图 11-2 所 示 。 

虽然 代码 完全 相同 ， 但 是 ， 由 于 JavaScript 的 存放 位 置 不 同 导 致 执行 结果 完全 不 一 样 。 
出 现 这 种 差异 的 主要 原因 是 由 于 HTML 代码 是 自 上 向 下 解释 执行 的 ， 在 demol.html 中 调 
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JH myFunction() 函数 时 ， 浏 览 器 还 不 知道 页 面 中 存在 id 为 myhead 和 demo 的 元 素 ， 所 以 
JavaScript 脚本 执行 无 效 ， 而 demo2.html 中 JavaScript 的 插入 位 置 在 myhead 和 demo 元 素 之 
后 ， 此 时 浏览 器 已 经 发 现 了 这 两 个 元 素 ， 所 以 能 够 正常 执行 。 


© file;//D-/DJango/JavaScripi/demo1.htmi 


这 是 一 个 标题 


这 旦 一 个 段落 


图 11-1 图 11-2 


当然 由 于 HTML 文档 是 解释 执行 的 ， 所 以 可 以 将 <script> 标签 放 在 页 面 的 任意 位 置 。 通 
常 如 果 在 脚本 中 不 对 HTML 元 素 进 行 任何 直接 操作 的 话 (本 例 中 不 调用 myFunction0 函数 )， 
则 可 以 将 脚本 放 在 <head> 标签 中 ， 如 果 需 要 操作 HTML 元 素 则 需要 注意 脚本 的 执行 时 机 。 


11.2.2 在 HTML Jt cts ERR, JavaScript 


在 需要 对 HTML 元 素 进行 事件 处 理 时 ， 可 以 直接 将 JavaScript 代码 嵌入 HTML 元 素 的 
事件 中 。 

例如 当 文 本 框 失 去 焦点 时 判断 文本 框 内 容 是 否 为 空 ， 如 果 文 本 框 内 容 为 空 则 弹出 提示 框 
提示 用 户 输入 信息 ，demo3.html: 


浏览 器 访问 效果 如 图 11-3 所 示 。 


< > © [O filey//D:/Django/JevaScript/demo3.htmi 


| | gam : 


ENS! 


11-3 
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11.2.3 引入 外 部 JavaScript 脚本 文件 


对 于 大 型 Web 项 目 来 说 ，JavaScript 的 内 容 往往 很 长 ， 尤 其 是 需要 引入 第 三 方 JavaScript 
类 库 时 ， 或 者 同一 段 JavaScript 脚本 需要 在 多 个 页 面 使 用 时 ， 可 以 将 这 些 JavaScript 脚本 写 
成 独立 的 js 文件 ， 然 后 在 HTML 文档 中 进行 调用 。 

例如 可 以 将 demo2.html 中 的 myFunction( 函数 写 在 myJavaScript.js 中 ，myJavaScript.js 
与 demo2.html 放 在 同一 个 文件 夹 下 。 

myJavaScript.js 脚本 文件 内 容 如 下 : 


更 新 后 的 demo2.html: 


此 时 重新 在 浏览 器 中 打开 demo2.html， 效 果 不 变 。 


EE JavaScript 数据 类 型 O 


JavaScript 一 共 包 含 7 种 数据 类 型 : 字符 串 ( String)、 数 字 (Number), 44K (Boolean), 
数组 (Array)、 对 象 (Object)、 空 (Null), KEX (Undefined), 


11.3.1 字符 串 
字符 串 是 用 来 存储 字符 的 变量 ， 用 单 引号 或 者 双 引 号 包围 的 任意 文本 就 是 字符 串 ， 例 如 : 
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11.3.2 ”数字 


JavaScript 不 像 其 他 语言 一 样 根 据 数值 的 精度 将 数字 类 型 细 分 为 多 种 类 型 ，JavaSeript 只 
有 一 种 数字 类 型 ， 可 以 是 整数 、 小 数 等 ， 例 如 : 


11.3.3. 布尔 
布尔 类 型 只 有 两 个 值 : true 和 false， 例 如 : 


11.3.4 数组 


数组 对 象 用 于 保存 一 系列 值 ， 数 组 元 素 可 以 是 不 同类 型 。 
1. 使 用 Array() 对 象 创建 数组 


或 者 : 


2. 使 用 列表 创建 数组 


11.8.5 WHA 


JavaScript 的 对 象 用 大 括号 包围 ， 大 括号 内 ， 对 象 的 属性 以 键 值 对 的 形式 存放 ， 属 性 之 
间 以 逗号 分 隔 ， 例 如 : 
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var person-( 
name:"Aaron", 
age: 18, 
address:" 中 国 - 北 京 " 
] 


使 用 英文 句点 或 者 方 括号 访问 对 象 的 属性 : 


Age = person.age 
Address = person["address"] 


11.3.6 Null 
表示 变量 的 值 为 空 。 使 用 时 可 以 通过 将 变量 的 值 设置 为 null 来 清空 变量 。 

11.3.7 Undefined 
表示 变量 没有 声明 或 者 虽然 声明 了 但 是 没有 赋值 
JavaScript 可 以 对 变量 进行 运算 ， 如 算术 运算 、 赋 值 运算 等 

11.4.1 算术 运算 符 


算术 运算 符 如 表 11-1 所 示 。 


表 11-1 


描 述 
加 法 运算 
减法 运算 


求 余 数 运算 
累加 运算 
递减 运算 


11.4.2 ”赋值 运算 符 


赋值 运算 符 如 表 11-2 所 示 。 
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表 112 


先 加 法 运算 再 赋值 
先 减法 运算 再 赋值 
先 乘法 运算 再 赋值 


先 求 余数 运算 再 赋值 


11.4.3 ”逻辑 运算 符 


逻辑 运算 符 如 表 11-3 所 示 
x 11-3 


逻辑 与 ， 只 有 当 运 算 符 两 边 的 变量 都 为 tue 时 ， 才 返回 tmue， 否 则 返回 false 


逻辑 或 ， 只 要 运算 符 两 边 的 任意 一 个 变量 为 tue， 表 达 式 返回 true， 否 则 返回 false 
逻辑 非 ， 操 作 数 是 true 则 返回 false， 操 作 数 是 false 则 返回 true 


11.4.4 ”比较 运算 符 


比较 运算 符 如 表 11-4 所 示 


表 11-4 
比较 运算 符 描 述 
- 4T 
m 全 等 ( 值 和 类 型 ) 
= 不 等 于 
> 大 于 
< 小 于 
>= 大 于 或 等 于 


EJ 流程 控制 语句 


11.5.1 if FFEA 


应 条件 判断 语句 用 于 判断 指定 条 件 是 否 为 真 ， 条 件 为 真 时 则 执行 代码 。 让 语句 的 语法 如 下 : 
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当 需 要 对 条 件 为 假 时 进行 其 他 操作 可 以 使 用 else 语句 : 


当 存 在 多 种 情况 时 可 以 使 用 if... else if... else 语句 ，else if 可 以 多 次 使 用 : 


下 面 是 用 于 判断 学 生成 绩 的 条 件 判断 语句 : 


当 sum 大 于 等 于 85 时 ， 网 页 弹出 “优秀 ”提示 框 ， 当 sum 大 于 等 于 60 时， 网 页 弹出 
“合格 ”提示 框 ， 否 则 弹出 “不 合格 ”。 
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11.5.2. switch 选择 语句 


switch 语句 是 典型 的 分 支 语 句 ， 当 表达 式 的 值 与 switch 的 某 一 个 分 支 条 件 一 样 时 则 执行 
该 分 支 代码 ， 如 果 表 达 式 的 值 与 任何 分 支 条 件 都 不 一 样 时 则 执行 default 代码 块 。switch 的 语 
法 如 下 : 


下 面 代码 通过 switch 语句 判断 今天 是 星期 几 : 
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11.5.3 while 循环 语句 


while 循环 语句 会 在 条 件 为 真 的 时 候 循环 执行 while 内 部 代码 块 ，while 的 语法 如 下 : 


例如 循环 输出 数字 0 到 10: 


注意 ,一 定 要 为 while 循环 设 定 退 出 条 件 ， 否 则 网 页 会 一 直 停留 在 while 内 部 。 
11.5.4 for 循环 语句 
for 循环 同样 是 根据 指定 条 件 循 环 执行 内 部 代码 ， 语 法 如 下 : 


初始 表达 式 一 般 用 于 初始 化 计数 器 ; 条 件 语句 用 于 对 计数 器 进行 判断 ; 更 新 表达 式 用 于 
更 新 计数 器 。 
同样 以 输出 数字 0 到 10 为 例 ， 查 看 如 何 使 用 for 循环 : 


11.5.5 continue 循环 中 断 语句 


continue 语句 可 以 用 来 终止 循环 语句 中 的 某 一 次 执行 ， 例 如 只 输出 数字 0 到 10 中 的 奇数 : 
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11.5.6 break 循环 退出 语句 
break 语句 可 以 退出 后 续 循环 ， 例 如 只 输出 小 于 5 的 数字 : 
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函数 就 是 一 段 执 行 具 体 功能 的 代码 块 ， 通 过 使 用 函数 可 以 提高 代码 重用 性 。 
JavaScript 函数 以 function 关键 字 表 示 ， 如 前 面 提 到 的 : 


JavaScript 函数 还 可 以 接收 参数 ， 参 数 之 间 以 逗号 分 隔 ， 带 参数 函数 的 签名 形式 如 下 : 


在 调用 带 参数 的 函数 时 ， 传 递 的 参数 值 必须 与 函数 声明 时 的 参数 位 置 一 致 ， 如 第 一 个 参 
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数 是 name， 那 么 传递 的 参数 就 必须 是 name 值 。 
函数 还 可 以 提供 返回 值 ， 如 进行 加 法 运算 的 函数 : 


调用 add 函数 : var sum = add(3, 5)， 此 时 sum 的 值 等 于 3+5。 


国友 JavaScript 与 HTML DOM 


DOM 的 全 称 为 文档 对 象 模型 (Document Object Model), DOM 人 允许 代码 动态 地 读 取 和 
更 新 文档 的 内 容 、 结 构 和 样式 。 


11.7.1 查找 HTML 元 素 


JavaScript 可 以 通过 很 多 方式 查找 HTML 元 素 ， 比 较 常见 的 有 以 下 两 种 : 
O 通过 id 查找 HTML 元 素 ; 

口 通过 标签 名 查找 HTML 元 素 。 

代码 示例 : 


在 这 里 需要 注意 的 是 ， 通 过 id 查找 元 素 的 方法 是 单数 形式 (Element) 而 通过 标签 名 
查找 元 素 的 方法 是 复数 形式 ( Elements)。 这 是 因为 一 般 情况 下 ， 网 页 中 元 素 的 id 是 唯一 
的 ， 不 会 重复 ， 而 标签 可 以 重复 ， 所 以 getElementById() 所 取得 的 是 一 个 DOM 对 象 ， 而 
getElementsByTagName() 通常 会 取得 一 系列 DOM 元 素 。 


11.7.2 ”修改 HTML 元 素 内 容 


JavaScript 可 以 动态 修改 元 素 内 容 。document.write() 可 用 于 直接 向 HTML 文档 写 和 内容， 
如 以 下 代码 直接 在 网 页 中 输出 当天 日 期 : 
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需要 修改 HTML 元 素 内 容 时 可 以 使 用 innerHTML 或 者 innerText 属性 ， 如 : 


|| ^ > © |O file///Dy/Django/JavaScript/demol html *l| i 


<span style='color:red;'> New text! </span> 


图 11-4 


虽然 向 pl 和 p2 两 个 元 素 中 输入 的 内 容 相同 ， 但 是 由 于 pl 使 用 了 innerHTML， 所 以 输 
出 了 格式 化 的 文本 ， 而 p2 使 用 了 innerText， 则 原样 输出 了 文本 。 


11.7.3 ”修改 HTML 元 素 属性 
通过 JavaScript 可 以 修改 元 素 属性 ， 语 法 如 下 : 


例如 修改 图 片 的 sre 属性 : 
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11.7.4 (EK HTML 元 素 样式 
通过 JavaScript 可 以 修改 元 素 样 式 ， 语 法 如 下 : 


例如 修改 <p> 标签 的 文字 颜色 : 


11.7.5 ”处理 HTML 元 素 事件 


JavaScript 是 事件 驱动 的 脚本 语言 ， 所 以 可 以 接收 并 处 理 HTML 元 素 事件 。 
下 面 代码 会 在 网 页 上 显示 一 段 文 本 和 一 个 按钮 ， 当 单 击 按钮 时 文本 颜色 变 成 蓝 色 。 
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除了 onclick 事件 外 ，DOM 元 素 还 有 很 多 种 事件 ， 如 鼠标 移入 移出 事件 onmouseover 和 
onmouseout， 鼠 标 按键 按 下 和 抬 起 事件 onmousedown 和 onmouseup ， 元 素 失 去 焦点 的 onblur 
事件 ， 元 素 获 得 焦点 的 onfocus 事件 ， 页 面 加载 完 成 的 onload 事件 等 。 


55128 
MySQL 


MySQL 是 目前 最 流行 的 关系 型 数据 库 管 理 系统 之 一 ， 也 是 目前 Web 应 用 中 最 受 欢迎 的 
数据 库 。 本 章 将 简要 介绍 MySQL 数据 库 的 安装 与 基本 操作 。 


EFE MySQL 的 安装 与 配置 


12.1.1 MySQL 版 本 


打开 MySQL 官 网 找到 下 载 页 面 ， 如 图 12-1 所 示 ， 可 以 看 到 MySQL 包括 Enterprise, 
Community 等 不 同 版 本 ，Enterprise 版 本 由 MySQL 官方 提供 技术 支持 ， 功 能 丰富 但 是 需要 付 
费 ,Community 版 本 由 开源 社区 支持 ， 提 供 免费 下 载 。 本 书 全 部 内 容 均 使 用 Community 版 本 。 
MySQL 官网 地 址 : https://www.mysqlcomy/downloads/。 


bose Q 


MySQL. MYSQLCOM DOWNLOADS DOCUMENTATION DEVELOPER ZONE 


Enterprise Community YumReposkory APTRepositoy SUSEReposkory Windows Archive 


图 12-1 


12.1.2. 在 Linux 系统 中 安装 MySQL 


本 节 内 容 以 CentOS 7 为 例 讲 解 如 何 安装 MySQL. CentOS 系统 中 默认 的 yum 源 可 能 
是 国外 地 址 ， 所 以 在 安装 软件 时 可 能 会 因为 网 速 问题 导致 安装 失败 ， 因 此 推荐 使 用 国内 yun 
源 。 下 面 以 更 换 网 易 yum 源 为 例 ， 讲 解 如 何 更 换 CentOS 7 yum 源 ， 如 果 读 者 的 CentOS 系 
统 是 阿里 云 服 务 器 或 者 其 他 国内 服务 器 的 话 ， 一 般 服务 器 提供 商 已 经 将 yum 源 更 改 为 国内 源 
了 ， 这 类 读者 可 以 忽略 本 段 内 容 。 
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(1) 备份 CentOS-Base.repo 文件 。 


(2) 下 载 网 易 yum repo 文件 。 


其 他 版 本 repo 文件 可 以 在 以 下 网 址 下 载 : http://mirrors.163.com/.help/centos.html。 
(3) 保存 文件 。 将 步骤 2 下 载 的 repo 文件 保存 到 /etc/yum.repos.d/ 文件 夹 下 。 
(4) 生成 缓存 。 


更 新 完 yum 源 之 后 就 可 以 安装 MySQL 数据 库 了 ， 由 于 Centos 7 默认 使 用 MariaDB £ 
代 MySQL， 所 以 如 果 直 接 执行 yun install mysql 命令 的 话 会 提示 安装 MariaDB。 如 果 和 希望 安 
装 旧版 MySQL， 可 以 通过 下 载 安装 包 的 方式 进行 安装 。 

(1) 下 载 MySQL 源 安装 包 : 


(2) 安装 MySQL ii: 


(3) 检查 MySQL 源 是 否 安装 成 功 : 


!mysql-connectors-community/x86 64 MySQL Connectors Community 42 
!mysql-tools-community/x86 64 MySQL Tools Community 55 
!mysqi57-community/x86 64 MySQL 5.7 Community Server 227 


(4) 安装 MySQL: 


C5) 启动 MySQL 服务 : 


(6) 设置 开机 启动 : 


(7) 修改 root 本 地 登录 密码 : 
MySQL 安装 完成 后 ， 在 /var/log/mysqld.log 文件 中 给 root 生成 了 一 个 默认 密码 。 通 过 下 
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面 的 方式 找到 root 默认 密码 ， 然 后 登录 MySQL 进行 修改 : 


[rootélocalhost -]£ grep ‘temporary password' /var/log/mysqld.log 
2018-01-03T15:33:22.0688927 1 [Note] A temporary password is generated for root@ 
localhost: ZüKjhlIafe7*e 


使 用 root 账号 连接 MySQL 数据 库 : 


修改 密码 : 


(8 ) 查看 用 户 权限 : 


my show grants for 'root'&'localhost'; 


十 
1 GRANT ALL. PRIVILEGES ON *.* TO 'root'@'localhost' WITH A OPTION | 
1 GRANT PROXY ON ''G'' TO 'root'&'localhost' WITH GRANT OPTI | 


pp pp ep st tt tt ee 


2 rows in set (0.00 sec] 

(9) 设置 MySQL 默认 编码 : 

MySQL 的 默认 编码 是 Latin1 ， 不 支持 中 文 ， 所 以 在 使 用 之 前 需要 将 默认 编码 修改 为 utf8。 
修改 /etc/my.cnf 配置 文件 ， 在 [mysqld] 配置 节点 下 添加 以 下 内 容 : 


改 结束 ， 重启 MySQL 服务 ， 查 看 数据 库 默认 编码 : 


mysql> show variables like 'characters'; 
* * 


* 
character set client 1 utf8 | 
character set connection | utf8 | 
character set database utf8 I 
character set filesystem | binary | 

| character set results | utf8 | 

| character set server | utf8 I 
character set system | utf8 | 
character sets dir | /usr/share/mysql/charsets/ l 


S EE ep NA UARNENINRC 


à rows in set (0.03 sec) 


12.1.3. 1E Windows 系统 中 安装 MySQL 


依次 单 击 Windows 一 MySQL Installer, JJF Windows 版 本 下 载 页 面 ， 根 据 个 人 情况 选 


择 在 线 安装 包 或 离线 安装 包 ， 截 至 2017 
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年 12 月 ， 最 新 的 MySQL 版 本 是 MySQL 5.7.20。 


如 果 在 下 载 页 面 遇 到 Oracle 登录 请 求 ， 可 以 单 击 “ No thanks, just start my download. " 


链接 直接 开始 下 载 。 


接受 安装 协议 ， 如 图 12-2 所 示 。 


[1 MySQL Installer 


MySQL Installer 


License Agreement 


To proceed you must accept the Oracle Software License Terms. 


GNU GENERAL PUBU LICENSE 
Version 2. June 1991 


Çopyrighe (c) 1509, 1981 Free Software Foundition, he, 


a, bua changing it i not alowed. 


hanga it By contract, the GNU Genera 

intended to guarantee your freedom to share and char 
ee cure the ccftware ic free for alite ucere. Thi 

icence applies to most of the Free Software. 

software and to any other program whose authors commit to 

ve other Free Software Foundation software is covered by 

[Ihe GNU Library General Public Lcense instead.) You can apply itto 

your programs, too. 


When we speak of free software. we are referring to freedom, not price 
Dur General Pubic Licenses are designed to make sure that you have 
nf me entware (and rharnp for thic 


Choosing a Setup Type 
Please select the Setup Type that suits your use case. 


Setup Type Desciiption. 


© Developer Default 
Installs ali products needed for 
MySQL development purposes. 


lappiications. 


© Glientonyy 


Installs orly tne MYSQL Client 
products, without a sewer. 


Or 
Installs allinduded MySQL 
producs and festurec. 


Custom. 
Manually ielect the products that 
sheulc be installed on the 
sysem. 


[installs oniy the MySQL Server. This type shouid 
[be used where you want tc deploy a MySQL 
Server, but wil nat be developing MySQL 


图 12-3 
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环境 检查 ， 如 图 12-4 所 示 。 


MySQL Installer Installation 


Addi nit 


Press Execute to upgrade the following products. 


Product. Status Progress 
T 


Ready to Install 


Click [Execute] to install or update the following packages 


图 12-4 


fif; Execute 按钮 ， 弹 出 界面 如 图 12-5 所 示 。 


jr 


Q alle Installation 


Press Execute to upgrade the following products. 


Product Status Progress Notes 


MySQL Server 5720. Complete | 


图 12-5 
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如 果 遇 到 以 下 安装 错误 ， 可 到 微软 官网 下 载 VCH Redistributable Packages 并 安装 
(注意 如 果 安 装 vcredist x64.exe 不 能 解决 问题 的 话 请 尝试 安装 vcredist x86.exe): 
错误 信息 : 


This application requires Visual Studio 2013 Redistributable. Please install 
the Redistributable then run this installer again. 


"n Next 按钮 ， 弹 出 界面 如 图 12-6 所 示 。 


MySQL Installer Type and Networking 


@ Standalone MySQL Server / Classic MySQL Replication 
Choose this option if you want to run the MySQL Server either standalone with 
the opportunity to later configure classic MySQL Replication. 


Using this option you can manually configure your replication setup and provide 
your own high availability solution if required 


© InnoDB Cluster Sandbox Test Setup (for testing only) 
The InnoDB cluster technology provides an out-of-the-box HA (high availability) 
solution for MySQL using Group Replication technology. 


This option allows you to test an InnoDB cluster setup on your local machine 
using several MySQL Server sandbox instances. Read more about this here . 


To setup a real-world production InnoDB cluster please choose the standard 
MySQL Server configuration instead on all desired hosts and use the MySQL Shell 
afterwards to create or expand the InnoDB cluster setup. 


Z N ^ 
eI — —. 8 
InnoDB rem 


图 12-6 


单 击 Next 按钮 ， 弹 出 界面 如 图 12-7 所 示 ， 选 择 服务 器 类 型 ， 对 于 开发 环境 来 说 ， 选 择 
默认 的 Development Machine 即 可 。 
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MySQL. Installer 


MySQL. Installer 


Type and Networking 


Server Configuration Type 


Choose the correct sorver coniguntica type for this MYSQL Serve salon, THis sting vill 
define how much system resour ned to the MySQL Server instance. 


Config Type 


Connectivity 


Use the following controls to select how you would like to connect to this server 


TEPP Port Number: 3306 
国 Open Firewall port for network access 


IF] Named Pipe Pipe Name. [MYSQL 
IF] Shared Memory Memory Name: |MYSQL 
Advanced Configuration. 


Select the checkbox below to get additional configuration page where you can set advanced 
options for this server instance. 


El Show Advanced Options 


<Back ][ Net> Cancel ] 


Next 按钮 ， 设 置 root 账号 


图 12-7 


密码 并 添加 其 他 用 户 ， 如 图 12-8 所 示 。 


Accounts and Roles 


Root Account Password 
Enter the password for the root account. Please remember to store this password in a secure. 
place. 


MYSQL Root Password —— eeeeeeee 
Repeat Password: m— 


Password Strength: 


MySQL User Accounts 


Create MySQL user accounts for your users and applications. Assign a role to the user that 
consists of a set of privileges. 


Wo 
Delete 
zer e 


图 12-8 


E Next 按钮 ， 将 MySQL 配置 为 Windows 系统 服务 ， 如 图 12-9 所 示 。 
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Windows Service 


国 Configure MySQL Server as a Windows Service 


Windows Service Details 
Please specify a Windows Service name to be used for this MySQL Server instance. A unique. 
name is required for each instance. 


Windows Service Name MySQUST| 
] Start the MySQL Server at System Startup. 


Run Windows Service as „.. 
The MySQL Server needs to run under a given user account. Based on the security 
requirements of your system you need to pick one of the options below. 


@ Standard System Account 
Recommended for most scenarios. 


© Custom User 
An existing user account can be selected for advanced scenarios. 


图 12-9 


单 击 Next 按钮 ， 弹 出 界面 如 图 12-10 所 示 。 


M Plugins and Extensions 


My MySQL as a Document Store 


Use the following controls to select how you would like to connect to this server 
IE] Enable X Protocol / MYSQL as a Document Store. 
Port Number: 33060 


Open Firewall port for network access 


Starting with MySQL Server 5.7, MySQL supports document store development. In 
order to provide a complete document store/NoSQL experience there is a new 
Communications protocol called the X Protocol. The expanded capabi 

Protocol enable us to provide modern developer APIs with features such as 
asynchronous calis, pipelining, and more. In addition to implementing document 
collections, the new X DevAPI also supports relational and combined document 
store/relational capabilities. Now developers, designers and DBAs can deploy 
MySQL databases that implement document store, relational, or hybrid 
 document/relation models. 


a 


ick here to view a Document Store online documentati 


图 12-10 


单 击 Next 按钮 ， 弹 出 界面 如 图 12-11 所 示 。 


| 136 Django 2.0 入 门 与 实践 


MySQL Installer 


Serve 


MySQL Installer 


Apply Configuration 
Press [Execute] to apply the changes 
Configuration Steps [Log] 


O Stopping Server [if necessary] 


o 


Writing configuration file 


o 


Updating firewall 


Adjusting Windows service [if necessary] 


Oo 


Initializing Database [if necessary] 
Starting Server 
Applying security settings. 


Creating user accounts. 


Ooooo 


Updating Start Menu Link 


o 


Updating Firewall for MySQL Document Data Feature Set 


图 12-11 


Execute 按钮 ， 弹 出 界面 如 图 12-12 所 示 。 


Apply Configuration 
The configuration operation has stopped. 


Configuration Steps |Log. 


@ Stopping Server [if necessary] 

Writing configuration file 

Updating firewall 

Adjusting Windows service [if necessary] 
Initializing Database [if necessary] 
Starting Server 

Applying security settings 

Creating user accounts 


Updating Start Menu Link 


&€e€€6€€€66«€6 66 


Updating Firewall for MySQL Document Data Feature Set 
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PA 数据 库 操 作 


12.2.4 创建 数据 库 
使 用 以 下 命令 创建 数据 库 : 


CREATE DATABASE "blog' DEFAULT CHARACTER SET utf8 COLLATE utf8 general ci; 

命令 解释 : 

CREATE DATABASE "blog : 创建 名 为 blog 的 数据 库 。 

DEFAULT CHARACTER SET utf8: 数据 库 所 使 用 的 默认 字符 集 为 utf8。 

ci 的 全 拼 是 case insensitive， 即 “大 小 写 不 敏感 ”, 例如 字母 a 和 A 在 字符 判断 中 会 被 当 
作 一 样 的 。 

COLLATE utf8 general ci; 使 用 utf8 字符 集 对 文字 进行 校 验 ， 校 验 时 不 区 分 大 小 写 。 

查看 现 有 数据 库 的 命令 如 下 : 


SHOW DATABASES; 


12.2.2 ”创建 数据 库 表 


使 用 以 下 命令 创建 数据 库 表 : 


USE blog; 
CREATE TABLE blog (id INT NOT NULL PRIMARY KEY, title VARCHAR(100), body 
VARCHAR (1000) ) ; 


命令 解释 : 

USE blog: 指定 当前 命令 使 用 名 为 blog 的 数据 库 。 

CREATE TABLE blog: 创建 数据 表 blog- 

id INT NOT NULL PRIMARY KEY: 数据 表 blog 的 主键 。 

title VARCHAR(100), body VARCHAR(1000): 数据 表 的 其 他 字段 。 


122.3 ”创建 用 户 


使 用 以 下 命令 创建 用 户 : 


CREATE USER 'sa'G'localhost' IDENTIFIED BY 'password'; 


命令 解释 : 
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在 主机 “localhost” 上 创建 用 户 “sa”， 密码 为 “password”。 


12.24 ”为 用 户 授权 


使 用 以 下 命令 为 用 户 授权 : 

GRANT ALL ON *.* TO 'sa'G'localhost'; 

语法 解释 : 

GRANT ALL : 为 用 户 赋 予 所 有 数据 库 权 限 ， 如 果 只 需要 特殊 操作 权限 的 话 ， 例 如 
SELECT 、INSERT、UPDAIE 权 限 ， 则 使 用 GRANT SELECT 或 者 GRANT SELECT, 
INSERT, UPDATE. 

ON *.* : 权限 对 应 的 数据 库 和 表 名 ，*.* 表示 全 部 数据 库 的 全 部 表 ，blog.* 表示 针对 blog 
数据 库 的 所 有 表 授 权 ，blog.blog 表示 只 针对 blog 数据 库 的 blog 表 授 权 。 

TO 'sa'@'localhost': 被 授权 的 用 户 。 


[12:3 数据 的 增 则 改 查 


12.3.1 INSERT 


语法 : 


INSERT INTO table name ( fieldl, field2,...fieldN ) 
VALUES 
( valuel, value2,...valueN ); 


语法 解释 : 

向 数据 表 中 插 人 数据 ，fieldl field2, .., fieldN 是 所 有 数据 所 对 应 字段 名 ，valuel， 
value2, .., valueN 是 所 有 字段 值 。 

示例 : 

INSERT INTO blog(id,title,body) VALUES(1,' 认识 Django','Django 是 基于 Python 语 言 
开发 的 一 套 重量 级 Web 框架 ， 其 设计 的 初衷 就 是 为 了 帮助 开发 人 员 以 最 小 的 代码 量 快速 建 
Wis '; 


12.3.2 SELECT 


语法 : 
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语法 解释 : 

SELECT 命令 可 以 读 取 一 条 或 者 多 条 记录 。 

使 用 星 号 CO) 来 代替 其 他 字段 ， 此 时 SELECT 语句 会 返回 表 的 所 有 字段 数据 。 
使 用 WHERE 语句 来 设置 查询 条 件 。 

使 用 LIMIT 属性 来 设 定 返回 的 记录 数 。 

使 用 OFFSET 指定 SELECT 语句 开始 查询 的 数据 偏 移 量 。 默 认 情 况 下 偏 移 量 为 0。 
示例 : 


12.3.3 UPDATE 


语法 : 


语法 解释 : 

更 新 数据 表 中 的 一 个 或 多 个 字段 。 
使 用 WHERE 子 句 限定 被 更 新 数据 。 
示例 : 


12.3.4 DELETE 


语法 : 


语法 解释 : 

如 果 没 有 指定 WHERE TJ, MySQL 表 中 的 所 有 记录 将 被 删除 。 
可 以 使 用 WHERE 子 句 限定 被 删除 的 数据 。 

示例 : 


SN 
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EE Ad Django 


Django 是 基于 Python 语言 开发 的 一 套 重量 级 Web 框架 ， 其 设计 的 初衷 就 是 为 了 帮助 开 
发 人 员 ista dim hit] eoa Django 通过 丰富 的 内 置 功能 使 开发 人 员 摆 脱 了 很 多 以 往 
Web 开发 中 的 困难 ， 得 以 将 更 多 精力 专注 于 自己 的 网 站 开发 中 

另外 ，Dijango = T BSD 协议 并 完全 免费 开源 的 开发 框架 ,任何 人 都 可 以 使 用 ， 
Django 的 GitHub 地 址 是 https://github.com/django 

从 本 章 开始 将 正式 带领 读者 进入 Django 的 世界 ,详细 学 习 这 门 开发 框架 。 


A 版 本 选择 

自从 Django 1.0 版 本 开始 ，Django 按照 以 下 形式 命名 版 本 编号 : 按照 A.B 或 A.B.C 的 
形式 命名 版 本 编号 。A.B 是 主 版 本 号 ， 包 含 新 功能 以 及 对 原 有 功能 的 改进 ， 每 一 个 新 版 本 都 
向 前 兼容 ，Django 大 概 每 8 个 月 就 会 发 布 一 个 主 版 本 ; C 是 小 版 本 号 ， 包 含 bug 的 修改 等 ， 
每 当 有 需要 时 就 会 发 布 。 在 Django 正式 版 本 发 布 之 前 ， 还 会 发 布 alpha、beta 和 RC (Release 
Candidate ， 候 选 发 布 版 本 ) 版 本 。 另 外 ，Diango 长 期 支持 的 版 本 用 LTS 表示 。 

Dijango 推荐 使 用 Python 3 进行 开发 ， 而 最 后 一 个 支持 Python 2.7 的 版 本 是 Django 1.11 
LTS, X 13-1 是 Django 各 个 版 本 对 Python 的 支持 情况 (截至 2017 年 11 月)。 


表 13-1 
Django 版 本 Python 版 本 
1.8 2.7, 3.2 (截至 2016 4E), 3.3, 34, 3.5 
19, 1.10 27, 34, 3.5 
1.11 23, 34,. 35, 3:6 
2.0 34, A 36 
2.1 35, 36,37 
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Django 官方 对 各 个 版 本 的 支持 情况 如 图 13-1 所 示 。 


2015 2016 2017 2018 2019 2020 2021 


图 13-1 


从 图 13-1 可 以 看 出 ，Django 长 期 支持 的 版 本 包括 Django 1.8, Django 1.11 以 及 Django 
2.2。 其 中 Django 1.8 版 本 在 2018 年 3 月 底 终 止 支持 ， 而 Django 1.11 版 本 将 会 在 2020 年 3 
月 底 终 止 支持 ， 下 一 个 被 长 期 支持 的 版 本 是 Django 2.2。 

Django 未 来 版 本 的 支持 情况 如 表 13-2 所 示 。 


表 13-2 
主 版 本 主 版 本 最 终 支持 日 其 小 版 本 最 终 支 持 日 其 


Django2.2 LTS 2019 年 12 月 最 早 截止 于 2022 年 4 月 
Django3.2 LTS 2021 年 12 月 最 早 截止 到 2024 年 4 月 


年 
本 书 主要 以 Django 2.0 + Python 3.6 进行 讲解 ， 如 遇 到 与 Django 1.11 不 同 之 处 将 会 进行 
对 照 讲解 。 


搭建 开发 环境 


关于 Python 的 安装 请 参考 本 书 Python 部 分 章节 ， 下 面 主要 介绍 Django 2.0 的 安装 。 
安装 Django 2.0 版 本 的 代码 如 下 : 


pip install Django--2.0 


Django 的 源 代码 托管 在 GitHub， 对 于 开发 人 员 、 乐 于 提前 尝试 新 技术 的 人 员 或 者 
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Django 的 贡献 作者 ， 可 以 使 用 git 客户 端 下 载 最 新 代码 : git clone https://github.com/django/ 
django.git. 
当然 也 可 以 通过 下 载 压缩 包 的 方式 下 载 源 代 码 ， 下 载 地 址 : httpsz//github.com/django/ 


django/archive/master.tar.gz . 


E = 
des 


pip 是 随 Python 安装 包 安 装 的 Python 包 管 理工 具 。 


zt， 可 以 通过 以 下 方式 检查 是 否 安装 成 功 
1. pip list 
在 命令 行 窗口 输入 “pip list”"， 结 果 如 图 13-2 所 示 


图 13-2 


2. python -m django -version 
在 命令 行 窗 口 输入 “python -m django -version”， 结 果 如 图 13-3 所 示 


BIS Administrator Command Pi [eere] 


图 13-3 


3. django.get version() 
在 命令 行 窗 口 输入 “django.get_version()”， 结 果 如 图 13-4 所 示 。 


v.1980 64 bit CAMD64>] 


图 13-4 
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学 习 任 何 新 技术 都 不 是 一 件 容易 的 事情 ， 很 多 开发 人 员 喜 欢 花 费 大 量 时 间 进 行 碎 片 化 学 
习 ， 这 种 学 习 方式 虽然 能 够 满足 一 时 的 工作 需要 ， 但 是 并 不 能 使 其 深入 、 全 面 地 理解 一 门 技 
术 ， 因 此 很 多 开发 人 员 在 使 用 一 门 技术 很 长 时 间 之 后 还 是 不 能 灵活 应 用 它 ， 本 书 首先 带领 读 
者 使 用 Django 框架 快速 搭建 一 个 投票 类 网 站 ， 使 读者 能 够 从 整体 上 认识 Django， 然 后 再 对 
具体 技术 细节 进行 详细 介绍 ， 最 终 使 得 读者 能 够 深入 理解 并 掌握 Django。 

本 章 所 演示 的 投票 网 站 主要 包含 以 下 两 部 分 : 

Q 公开 的 网 站 前 台 部 分 ， 用 于 浏览 民意 测验 结果 以 及 进行 网 上 投票 。 

口 网 站 后 台 管 理 功能 ， 允 许 管理 员 添 加 、 修 改 、 删 除 调查 问卷 。 

开始 学 习 后 续 内 容 之 前 应 保证 在 电脑 上 已 经 安装 了 Python 3.6, Django 2.0 以 及 MySQL 
5.6。 为 照顾 大 多 数 读 者 ， 本 教程 采用 Windows 系统 作为 开发 环境 。 


|14.1 | 创建 Django 工程 


首先 新 建 一 个 名 为 demo 的 文件 夹 ， 打 开 命 令 行 提示 符 (在 “开始 ”菜单 中 输入 “ cmd. 
xe ”可 以 打开 )， 在 命令 行 提示 符 窗口 输入 “cd demo 文件 殉 的 路 径 "”， 将 命令 行 切换 到 
demo 文件 夹 ， 然 后 输入 下 面 命令 : 


> django-admin startproject mysite 


命令 执行 结束 后 ， 将 会 在 demo 文件 夹 下 创建 一 个 mysite 文件 夹 。 


! Q 应 避免 使 用 Python 内 置 的 包 或 者 Django 内 谋 组 件 名 来 命名 项 目 ， 例如 不 能 使 用 l 
| Django 来 命名 新 项 目 ， 因 为 这 会 与 Django 自身 产生 冲突 ， 也 不 能 使 用 test 作为 顶 上 | 
名 ， 因 为 这 会 与 Python 的 内 置 包 产生 冲突 。 
口 不 要 将 Django 项 目 代码 文件 与 其 他 网 站 项 目 放 在 一 E, ro 
置 在 Web 服务 器 的 根 目录 ， 因 为 这 样 可 能 会 将 Django 的 代码 暴露 在 浏览 器 中 。 
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此 时 demo 文件 夹 下 的 文件 目录 结构 如 下 : 


以 上 文件 结构 的 意义 如 下 。 

口 最 外 层 文件 夹 mysite 是 整个 项 目的 容器 ， 它 的 名 字 对 于 Django 来 说 没有 任何 意义 ， 虽 
然 创建 项 目的 时 候 使 用 了 mysite 作为 项 目 名 字 ， 但 是 我 们 可 以 随时 对 它 进行 重 命名 。 

口 根 目录 的 manage.py 脚本 文件 是 一 个 命令 行 工具 ， 通 过 使 用 这 个 文件 我 们 可 以 管理 
Django 项 目 ， 后 面 章 节 会 对 django-admin 和 manage.py 进行 详细 介绍 。 

O 第 二 级 的 mysite 文件 夹 才 是 当前 Django 工程 所 使 用 的 Python 包 (包含 _init py 文件 的 
Python 文件 夹 )。 这 个 文件 夹 的 名 字 将 会 被 用 来 导入 包 内 的 所 有 内 容 (例如 导入 mysite.urls)。 

口 mysite/ _init _.py: 表明 当前 文件 夹 是 一 个 Python 包 。 

口 mysite/settings.py : 当前 Django 工程 的 配置 文件 ， 在 后 面 章 节 会 对 Django 配置 进行 
详细 介绍 。 

O mysite/urls.py : 当前 Django 工程 的 路 由 配置 文件 ， 包 含 工程 的 路 由 信息 ， 在 后 面 章 
节 会 对 Django 路 由 系统 进行 详细 介绍 。 

口 mysite/wsgi.py : 兼容 WSGI 的 Web 服务 人 口 。Django 应 用 程序 是 基于 WSGI 服务 开 
发 的 ， 因 此 运行 或 部 署 Django 程序 时 需要 指定 WSGI 配 置信 息 ， 在 后 面 章节 会 介绍 
如 何 使 用 WSGI 部 署 Django 应 用 程序 。 


14.2 | 运行 Django 工程 
到 目前 为 止 , 已 经 搭建 好 一 个 最 简单 的 Django 工程， 下面 来 检查 这 个 工程 是 否 能 够 正 
常 运行 。 将 命令 行 提示 符 所 在 位 置 切换 到 最 外 层 的 mysite 文件 夹 ， 执 行 以 下 命令 : 


运行 结果 如 下 : 
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: 暂时 忽略 上 面 输出 结果 中 的 警告 信息 ( You have 14 unapplied migration(s).)。 这 是 
因为 新 建 的 Django 工程 还 没有 使 用 数据 库 。 i 


此 时 我 们 已 经 使 用 一 个 Python PIER E E Web 服务 器 运行 了 Django 工程 。 这 也 是 
Django 能 够 快速 开发 Web 应 用 程序 的 一 个 优势 一 一 在 开发 过 程 中 我 们 不 需要 关心 Web 服务 。 
如 果 细 心 观察 的 话 会 发 现 ， 在 polls 文件 夹 的 平 级 多 出 一 个 db.sqlite3 数据 库 文件 。 


po: 


这 种 运行 Django 应 用 程序 的 方式 的 稳定 性 和 网 站 性 能 都 很 差 ， 只 适用 于 开发 过 程 ， | 
绝对 不 能 应 用 在 生产 环境 中 ， 如 果 使 用 这 种 方式 部 署 Django 网 站 的 话 ， 当 用 户 登 出 服 | 
AEN, AN Web 服务 也 会 停止。 


现在 Django 应 用 已 经 运行 起 来 了 ， 打 开 浏览 器 在 地 址 栏 输入 “http:/127.0.0.1:8000/”， 
此 时 能 看 到 如 图 14-1 所 示 的 Django 欢迎 页 面 ， 说 明 Django 程序 已 经 创建 成 功 了 。 


| < > e [© 127001500 


django 


View release notes for Django 2.0 


The install worked successfully! Congratulations! 


You are seeing this page because DEBUG-True is in your. 
settings file and you have not configured any URLs. 


14-1 
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对 于 runserver 命令 ， 后 面 内 容 会 详细 介绍 。 


EE tgk Pols 应 用 程序 


前 面 已 经 完成 了 Django 工程 的 创建 ， 接 下 来 开始 创建 应 用 程序 。 每 一 个 Django 应 用 程 
序 都 包含 一 个 Python 包 。django-admin 和 manage.py 可 以 帮助 开发 人 员 快 速 创建 应 用 程序 文 
件 夹 ， 因 此 大 大 地 提高 了 开发 效率 。 


工程 (Project) 与 应 用 程序 (App): 前 面 多 次 提 到 Django 工程 与 应 用 程序 ， 那 么 工程 | i 


PCE 
Ur 而 一 个 应 用 程序 可 以 属于 多 个 工程 。 


应 用 程序 可 以 放置 在 任何 Python 路 径 能 够 识别 的 地 方 ， 在 本 教程 中 ， RUN IESRUY 
放 在 manage.py 的 同 级 目录 ， 这 样 方便 调用 。 
将 命令 行 提示 符 中 切换 到 manage.py 所 在 目录 ， 然 后 执行 以 下 命令 : 


命令 执行 结束 就 已 经 创建 好 了 应 用 程序 polls，polls 的 目录 结构 如 下 : 


EY 开发 第 一 个 视图 


Django 的 视图 是 负责 页 面 展示 的 重要 模块 ， 用 于 处 理 网 站 业务 逻辑 。 
打开 polls/view.py 文件 ， 添 加 以 下 代码 : 
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这 样 ， 一 个 最 简单 的 Django 视图 已 经 创建 完成 。 为 了 能 够 访问 它 ， 需 要 在 URL 中 添加 
路 由 映射 。 在 polls 中 创建 文件 urlspy， 并 在 urls.py 文件 中 添加 以 下 内 容 : 


接 下 来 需要 在 根 目 录 的 urls.py 中 引用 polls/urls.py， 修 改 mysite/urls.py 如 下 : 


上 面 代 码 中 include) 方法 可 以 用 来 引用 其 他 URLconfs (urls.py)。 通 过 合理 使 用 include) 
方法 可 以 将 整个 网 站 中 的 所 有 URL 分 配 到 多 个 文件 中 ， 使 代码 更 加 简洁 合理 。 
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到 目前 为 止 ， 我 们 的 Django 工程 中 已 经 包含 了 一 个 视图 。 重 新 调用 runserver 命令 启动 
Web 服务 ， 查 看 该 视图 是 否 能 够 正常 工作 。 
在 浏览 器 中 输入 “http://127.0.0.1:8000/polls/”， 按 Enter 键 ， 显 示 效 果 如 图 14-2 所 示 。 


U D) 12700.1:8000/polls/ x 


€ > C [O 1270.0.1:8000/polis/ 


你 好 ! 这 里 是 在 线 投票 系统 。 


Django 2.0 与 Django 1.11 的 区 别 


在 Django 1.11 中 使 用 url0 方法 创建 URL 映射 ，url0 方法 接收 4 个 参数 : 

(1 ) regex 

regex 是 正则 表达 式 ( regular expression) 的 简写 ， 用 于 匹配 字符 串 。Django 将 接收 到 
的 URL 按照 url pattern 在 urlpatterns 中 的 顺 写 进行 比较 ， 直 到 找到 第 一 个 匹配 的 地 址 。 

注意 以 上 正则 表达 式 不 会 比较 GET 或 POST 参数 ， 也 不 会 比较 网 站 服务 器 名 。 例 
如 对 于 请 求 https://www.example.com/myapp/，URLconf 只 会 匹配 myapp/， 而 对 于 请 求 
https://www.example.com/myapp/?page=3 也 只 会 匹配 myapp/。 

由 于 以 上 正则 表达 式 在 URLconf 第 一 次 被 加 载 时 就 会 被 编译 完成 ， 因 此 URLconf 的 | 
! 正则 表达 式 执行 速度 很 快 。 
(2) view 
当 Django 找到 了 匹配 的 正则 表达 式 后 ，Django 会 将 一 个 HttpRequest 对 象 作为 第 一 ! 
! 个 参数 、 其 他 正则 表达 式 捕 捉 到 的 值 作为 第 二 个 参数 传递 给 指定 的 视图 。 如 果 正 则 表达 式 
| 只 进行 简单 摘 所 的 话 ， 那么 捕捉 到 的 值 将 会 作为 位 置 参 数 进行 传递 ， 如 果 正 则 表达 式 按照 
| 名 字 捕 捉 值 的 话 ， 那 么 捕捉 到 的 值 将 会 作为 关键 字 参 数 进行 传递 。 


' (3) kwargs 
任何 关键 字 参 数 都 会 作为 字典 传递 给 目标 视图 。 | 
l (4) name ' 


| 为 URL 进行 命名 ,方便 在 Django 项 目的 其 他 位 置 使 用 名 字 来 引用 URL. 
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峙 意 


: 在 Django2.0 中 使 用 pathO 方法 创建 URL 了 映射 ,pathO 方 法 同样 接收 4 个 参数 : | 
| route, view, kwargs, name, [& route 参数 外 ， 其 他 3 个 参数 的 工作 方式 与 Django 1.11 中 
| url0 方法 的 参数 相似 。route 是 一 个 包含 URL 模式 的 字符 串 ， 其 工作 方式 与 Django 1.11 中 i 
!urlQ 方法 的 regex 相似 ， 最 主要 的 区 别 是 route 所 使 用 的 URL 模式 字符 串 可 以 指定 参数 | 
| 类 型 。 

DO 对 于 pathO 方法 ， 我 们 会 在 后 面 DRL 相关 章节 中 进行 详细 介绍 。 


PA nng 


对 于 现代 化 的 网 站 来 说 ， 数 据 存储 是 一 个 至 关 重 要 的 环节 ， 本 节 将 会 介绍 如 何 为 Django 
配置 数据 库 。 

前 面 提 到 Django 应 用 程序 的 配置 信息 都 存储 在 mysite/settings.py 文件 中 ， 数 据 库 配置 
也 不 例外 。settings.py 是 一 个 标准 的 Python 模块 ， 在 其 中 存放 了 很 多 模块 变量 ， 数 据 库 配置 
信息 就 是 其 中 的 一 个 变量 。 默 认 情 况 下 ，Django 使 用 SQLite 作为 数据 库 。SQLite 是 一 个 免 
安装 的 数据 库 系 统 ， 非 常 简单 易学 ，Python 已 经 提供 了 相应 的 支持 模块 ， 所 以 我 们 不 需要 做 
任何 事情 就 可 以 在 Django 中 使 用 SQLite 了 。 虽 然 SQLite 存在 如 此 多 的 优势 ， 但 是 当 我 们 将 
Django 程序 真正 应 用 到 生产 环境 时 ， 可 能 还 是 会 因为 各 种 原因 而 不 得 不 更 换 数据 库 。 因 此 
Django 官方 提供 了 对 4 种 数据 库 的 支持 : PostgreSQL, MySQL, Oracle 和 SQLite。 本 书 全 
部 内 容 均 以 MySQL 数据 库 为 例 。 

下 面 就 来 详细 介绍 如 何 为 Django 配置 MySQL 数据 库 的 支持 。 

(1 ) 安装 数据 库 绑 定 程序 : 由 于 Django 已 经 提供 了 对 MySQL 的 支持 ， 所 以 我 们 不 需要 
再 做 任何 额外 工作 了 。 

(2 ) 按照 以 下 格式 在 mysite/settings.py 中 设置 DATABASES 节点 : 


i 
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ENGINE: MySQL 数据 库 支 持 引擎 。 

NAME: 数据 库 名 。 

USER: 数据 库 用 户 名 ， 该 用 户 要 求 拥有 对 以 上 数据 库 的 SELECT、INSERT、 
UPDATE, DELETE 以 及 CREATE DATABASE 权限 。 

PASSWORD: 以 上 数据 库 用 户 的 密码 。 

HOST: 数据 库 所 在 主机 名 ， 如 果 是 本 地 机 器 的 话 可 使 用 127.0.0.1。 

PORT: 为 数据 库 开 放 的 端口 号 ， 如 果 值 为 空 表示 默认 端口 。 


B 
L3 
Á» 
aW 
E! 
zx 
3» 
N 
z 
X 
E 
se 
A 
3m 
x 
m 
mi 
[1 
ut 
p: 
g 
Li 
E 
m 
m 
Ek 
Lid 
R 


数据 库 配置 完成 ， 现 在 开始 创建 模型 (model) , 在 详细 学 习 Django 的 ORM 开发 之 前 ， 
读者 只 要 将 模型 理解 为 数据 库 表 的 Python 类 的 表现 形式 即 可 。 每 一 个 模型 对 应 一 个 数据 库 
表 ， 而 模型 的 属性 就 是 数据 库 表 的 字段 。 

在 线 投 票 系统 需要 两 个 模型 : 问卷 ( Question) 和 选项 ( Choice). Question 包含 两 个 字 
Bt question text (问卷 内 容 ) 和 pub. date (问卷 时 间 )， 同 时 Question 模型 包含 一 个 方法 was - 
published recentlyO 用 于 判断 问卷 是 不 是 最 近 (一 天 内 ) 发 布 的 ; Choice 同样 包含 两 个 字段 
choice text (选项 内 容 ) 和 votes (选项 得 分 )， 另 外 每 一 个 选项 都 必须 属于 一 个 问卷 。 结 合 以 
上 分 析 ， 修 改 polls/models.py 文件 完成 模型 代码 如 下 : 
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上 面 代 码 中 每 一 个 类 就 是 一 个 Django 模型 ， 它 们 都 继承 自 django.db.models.Model 类 ， 
而 模型 的 每 一 个 属性 都 是 Field 类 的 实例 ， 同 时 也 对 应 一 个 数据 库 表 的 字段 。 

数据 库 配 置 完成 后 ， 还 需要 进行 以 下 额外 配置 : 

O 配置 时 区 。Django 的 默认 时 区 是 “ TIME ZONE = 'UTC'"， 将 其 修改 为 中 国 时 区 : 
"TIME ZONE - 'Asia/Shanghai'" . 

O 配置 语言 。Django 的 默认 语言 是 英语 “LANGUAGE_ CODE = 'en-us'”"， 将 其 修改 为 
简体 中 文 “LANGUAGE CODE ='zh-Hans'” 。 

口 添加 应 用 程序 ， 使 Django 能 够 识别 polls. Django 自 定义 应 用 程序 信息 保存 在 polls/ 
apps.py 脚本 中 ， 按 以 下 格式 将 应 用 程序 名 polls 添加 到 INSTALLED APPS 节点 : 


当前 polls/apps.py 脚本 内 容 如 下 : 


执行 以 下 命令 创建 用 于 生成 数据 库 的 Python 脚本 : 
| Python manage.py makemigrations polla 00 
makemigrations 命令 告知 Django， 当 前 应 用 程序 polls 的 模型 发 生 改 变 ， 需 要 更 新 数据 
库 脚本 ， 数 据 库 脚本 存放 在 polls/migrations/ 文件 夹 下 ， 脚 本 名 形 如 0001_initialpy。 命 令 执 
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行 后 输入 如 下 信息 : 


通过 以 下 命令 可 以 查看 数据 库 脚本 内 容 : 


执行 下 面 命令 将 Django 中 的 数据 库 更 改写 人 MySQL: 


命令 输出 信息 如 下 : 


错误 提示 

如 果 执 行 migrate 命令 时 出 现 类 似 “ModuleNotFoundError: No module named 'MySQLdb'" 
的 错误 ， 在 错误 信息 最 下 方 会 有 相应 解决 方案 提示 ， 如 “Did you install mysqlclient?”。 只 需 
按照 提示 安装 相应 模块 即 可 ， 如 “pip install mysqlclient” 


将 数据 库 更 新 拆 分 成 makemigrations 和 migrate 两 个 命令 的 好 处 是 方便 使 用 源 代 码 管 
i 理工 具 保存 数据 库 更 新 时 所 生成 的 migrations 文件 。 


EX Django Admin 模块 


Django 是 一 款 非常 强大 的 Web 开发 框架 ， 尤 其 是 它 内 置 的 Admin 模块 使 得 开发 人 员 在 
不 做 任何 代码 编写 的 情况 下 就 拥有 了 网 站 后 台 管理 功能 。 
执行 以 下 命令 创建 网 站 超级 管理 员 : 


第 14 章 “搭建 第 一 个 Django 网 站 155 | BIS 


按照 命令 提示 输入 用 户 名 、 邮 箱 地 址 、 密 码 。 

超级 管理 员 创建 成 功 后 ， 启 动 Web 服务 : python manage.py runserver。 

服务 启动 之 后 ， 打 开 浏 览 器 ， 在 地 址 栏 输入 网 址 :“ http://127.0.0.1:8000/admin/”， 按 
Enter 键 打 开 Django Admin 后 人 台 登 录 页 面 ， 如 图 14-3 所 示 。 

在 登录 页 面 输入 刚刚 创建 的 超级 管理 员 用 户 名 和 密码 ， 单 击 “ 登 录 ” 按 钮 进入 后 台 管 理 
页 面 ， 如 图 14-4 所 示 。 


€ © 9-9 n/127001800/adminnogintnex-/admüy $ 


Q D sza1opjpnoozasss x 二 


Django 2.0 5 Django 1.11 的 区 别 


管理 后 台 样 式 自 适应 ， 支 持 移动 端 浏览 器 了 。 这 对 于 开发 人 员 来 说 真是 一 个 里 程 碑 式 
的 改进 ，Django 2.0 不 用 再 通过 左右 拖 动 来 查看 网 页 内 容 了 ，Django 已 经 做 好 了 各 种 尺寸 
浏览 器 的 自 适应 。 


下 面 是 几 种 不 同 尺 十 设备 的 模拟 现实 样式 。 
1. Galaxy S5 

Galaxy S5 的 样式 如 图 14-5 所 示 。 

2. iPhone 6 

iPhone 6 的 样式 如 图 14-6 所 示 。 


3. iPad 
iPad 的 样式 如 图 14-7 所 示 。 
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GelayS$ € 360 x 640 10x © iPhone& v 375 x 667 100% © 
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图 14-7 
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可 编辑 Admin 模块 


到 目前 为 止 ， 投 票 系统 已 经 有 了 超级 管理 员 账 号 ， 也 有 了 网 站 后 台 管 理 系 统 ， 但 是 后 
台 系 统 还 是 缺少 对 基本 数据 的 修改 功能 ， 如 没有 问卷 发 布 功能 。 接 下 来 我 们 看 看 如 何 使 得 
Django 管理 后 台 能 够 添加 并 修改 问卷 。 

打开 polls/admin.py 文件 ， 添 加 以 下 代码 : 


from django.contrib import admin 
from .models import Question 


admin.site.register (Question) 


重启 Web 服务 并 刷新 后 台 管 理 页 面 ， 如 图 14-8 所 示 。 


zx 8x 
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图 14-8 
此 时 网 页 上 多 出 了 一 个 POLLS 模块 ， 其 中 有 一 行 Questions，Qnuestions 是 一 个 超 链 接 ， 
单 击 它 可 以 查看 全 部 已 有 问卷 。 由 于 目前 系统 中 还 不 存在 任何 问卷 ， 单 击 “ 增 加 ”按钮 添加 
一 条 问卷 信息 ， 如 图 14-9 所 示 。 


xd 


€ © 5-9 muannas 


图 14-9 
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保存 之 后 网 页 自动 跳 转 到 问卷 列表 页 面 ， 如 图 14-10 所 示 。 


图 14-10 


单 击 “Question object (1) ”进入 问卷 编辑 页 面 ， 如 图 14-11 所 示 。 


ourme ent [m] 


reee 
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可 以 看 出 Django 已 经 自动 完成 了 很 多 事情 : 

口 自动 生成 网 页 表单 ; 

口 根据 数据 字段 类 型 自动 生成 HTML 控件 ， 如 DateTimeField 类 型 数据 生成 日 期 时 间 控 
件 、CharField 生成 文本 控件 ; 

口 数据 增删 改 查 功能 ; 

口 部 分 文本 的 本 地 化 显示 (中 文 显 示 )。 


A 添加 视图 


现在 网 站 的 后 台 管理 模块 已 经 可 以 工作 了 ， 还 缺少 前 台 页 面 。 投 票 系统 需要 以 下 页 面 : 


口 首页 一 一 展示 最 新 的 调查 问卷 。 


口 详细 页 面 


口 结果 


展示 页 


具体 问卷 展示 页 ， 不 显示 投票 结果 但 是 可 以 进行 投票 。 
展示 某 一 问卷 的 调查 结果 。 
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口 投票 一 一 处 理 某 一 次 投票 。 

在 Django 中 每 一 个 页 面 或 者 其 他 内 容 都 是 通过 视图 呈现 出 来 的 ， 每 一 个 视图 就 是 一 个 
Python 函数 或 者 方法 。Django 通过 URL 确定 调用 哪 一 个 视图 ，Django 的 URL 相 较 于 早期 
网 站 的 URL 更 加 简洁 优雅 。 

Django 通过 URLconfs 将 URL 模式 字符 串 与 视图 关联 起 来 ，URL 模式 字符 串 就 是 一 个 
URL 的 一 般 形式 ， 如 /newsarchive/<year>/<month>/。 

下 面 在 polls/views.py 文件 中 添加 以 下 视图 : 


修改 polls.urls 文件 ， 添 加 以 下 URL 映射 : 


重启 Web 服务 器 ， 在 浏览 器 中 访问 http://127.0.0.1:8000/polls/24/， 如 图 14-12 所 示 。 


三 名 -~ 口 X 
€ © 9- Q http//1270018000/polls/24/ f*- x 


O j Dapvlz7oolaooor x |. 


将 为 您 打开 问卷 24. 


14-12 
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继续 访问 http://127.0.0.1:8000/polls/24/results/ 和 http://127.0.0.1:8000/polls/24/vote/, 可 
见 同样 能 够 正常 显示 视图 内 容 。 

Django 能 够 正常 调用 解析 URL 是 因为 在 settings.py 中 设置 了 ROOT URLCONF = 
'mysite.urls'。 当 用 户 访 问 的 URL 包含 polls/ Ff, Django 会 根据 mysite.urls 中 的 设置 ， 跳 转 到 
polls.urls 并 进行 验证 ， 直 到 找到 第 一 个 匹配 的 URL 为 止 。 

以 上 视图 中 参数 question. id 的 值 来 自 于 <int:question id>。<int:question id> 用 于 匹配 
URL 中 的 值 ， 并 将 捕捉 到 的 值 作为 关键 字 参 数 传递 给 视图 ， 其 中 ，question id 对 应 视图 的 
参数 ，<int 决定 了 URL 中 的 哪 类 值 符合 匹配 条 件 。 


EE 丰富 视 图 功能 
每 一 个 视图 都 应 该 负责 一 个 具体 的 业务 逻辑 ， 视 图 执行 结束 会 返回 一 个 包含 页 面 内 容 的 
HttpResponse 对 象 或 者 异常 信息 。 

下 面 修改 index 视图 使 它 返回 最 新 的 5 条 调查 问卷 


from .models import Question 
def index(request): 
latest question list - Question.objects.order by('-pub date')[:5] 
output = ', '.join([q.question text for q in latest question list]) 
return HttpResponse (output) 


有 


代码 Question.objects.order by(-pub date" X Django 的 数据 库 API 语 法 ， 用 于 从 数据 
! 库 中 查找 数据 ， 我 们 将 在 介绍 ORM 时 进行 详细 讲解 。 


访问 index 页 面 查看 显示 情况 ， 如 图 14-13 所 示 。 


T 
€ © 9- Qntp//12700.:8000/polls/ s- x3 
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你 喜欢 Django 吗 ? 


图 14-13 
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此 时 调查 问卷 已 经 在 网 页 上 显示 ,但 是 可 以 发 现在 index 视图 中 使 用 了 硬 编码 ， 如 
果 想 要 修改 网 页 显示 样式 就 需要 重新 编写 Python 代码 。Django 提供 了 一 套 模板 系统 
(templates)， 可 以 将 业务 逻辑 与 页 面 显示 样式 分 离 。 接 下 来 看 看 如 何 使 用 模板 系统 。 

首先 在 polls 文件 夹 下 创建 一 个 新 文件 夹 templates， 为 了 目录 结构 清晰 ， 在 templates X 
件 夹 下 再 创建 一 个 polls 文件 来， 最 后 在 polls 下 创建 一 个 index.html 文件 。 这 个 index.html 
就 是 即将 应 用 于 index 视图 的 模板 。 

在 settings.py 中 有 一 个 关于 模板 的 配置 项 : TEMPLATES. Django 就 是 根据 这 个 配置 查 
找 并 解析 模板 的 ， 具体 工作 原理 会 在 后 续 章 节 进 行 讲解 。 

将 下 面 代 码 写 人 模板 文件 index.html: 


接 下 来 重新 修改 index WA: 


新 视图 会 从 模板 文件 夹 下 加 载 模板 文件 并 将 一 个 字典 对 象 传人 视图 。 

重启 Web 服务 器 ， 重 新 查看 index 页 面 ， 如 图 14-14 所 示 。 

上 面 代码 的 工作 原理 是 先 使 用 loader 方法 加 载 视图 ， 然 后 HttpResponse 方法 初始 化 一 个 
HttpResponse 对 象 并 返回 给 浏览 器 。 对 于 很 多 Django 视图 来 说 ， 它 们 的 工作 原理 都 是 这 样 
的 ， 因 此 Django 提供 了 一 个 简写 函数 render。 下 面 使 用 render 函数 重 写 index 视图 : 
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mtUwv.-utx 
€ © 9- Q ntp/1210018000/polis/ fc xo 
O / D epj1270018000/; x | * 
* 你 喜欢 Diango 吗 ? _ 
图 14-14 


此 时 重新 访问 index， 可 以 发 现 页 面 效果 一 样 。 


. 


罗 处理 404 错误 


404 错误 是 一 个 比较 常见 的 网 页 访问 错误 ， 当 被 访问 的 URL 资源 不 存在 时 就 会 抛 出 这 类 
错误 。 下 面 修改 detail 视图 使 其 在 被 查找 的 问卷 不 存在 时 抛 出 404 错误 。 


按照 前 面 步骤 在 polls 文件 夹 下 创建 一 个 detail.html 文件 并 作为 detail 视图 的 模板 文件 ， 
模板 内 容 暂 时 用 {{ question }} 表示 。detailhtml 5j index.html 在 同一 文件 夹 下 。 
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此 时 重启 Web 服务 ， 访 问 一 个 不 存在 的 问卷 ， 例 如 http://127.0.0.1:8000/polls/1000/， 如 
图 14-15 所 示 。 


€ © 9- Q http//127.001:8000/polls/1000/ fc ox 


Y j D Page not found at/pc x (9. 


Page not found (44) 


Request Method: GET 
Request URL: http://127. 0. 0. 1:8000/po112/1000/ 
Raised by: polls.views.detail 


问卷 不 存在 


You're sesing this error because ysu have JEBUG = True a> settings file. 
Change that to False, and Django will display a Eu 404 p: 
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由 于 404 错误 也 是 一 个 非常 常见 的 网 页 异常 ， 所 以 Django 也 提供 了 一 个 简写 方法 : get_ 
object or 404。 下 面 使 用 get object or 4040 修改 detail 视图 : 


重新 访问 detail 页 面 ， 如 图 14-16 所 示 。 


md -0x 
€ © 9- © htp//127001:8000/polls/1000/ ?*-|5E 


OPEP 
4 / D Page not found at pe x | 


Page not found (44) 


Request Method: GET 
Request URL: http://127. 0. 0. 1:8000/po11s/1000/ 
Raised by: polls.views. detail 


No Question matches the given query. 


You're sesing this error because you have IEDUG = Tree in your Django settings file. 
Change that to False, and Django will display a standard 404 page. 


图 14-16 
此 时 网 页 仍然 抛 出 404 错误 ， 不 过 错误 信息 变 成 了 Django 默认 的 英文 形式 ， 此 时 可 
以 通过 修改 get object or 4040 方法 源 代 码 的 方式 修改 错误 信息 。 记 得 修改 完 get_object_ 
or 4040 方法 源 代码 需要 重启 Web 服务 。 
与 get object or 404 相似 ，Django 还 提供 了 一 个 判断 list 是 否 存在 的 方法 : get list 
or 404， 在 此 不 做 详细 介绍 。 
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A 使 用 模板 系统 


14.11.1 ”模板 语法 


前 面 的 detail.html 模板 过 于 简单 ， 现 实 中 Django 的 模板 系统 非常 强大 ， 可 以 制作 出 丰 
富 多 彩 的 网 页 效果 。 下 面 将 以 下 代码 复制 到 模板 文件 detail.html rh: 


<hl>{{ question.question text }}</hl> 

<ul> 

(*$ for choice in question.choice set.all $] 
<li>{{ choice.choice text }}</li> 

{% endfor $) 

</ul> 


上 面 代码 中 的 双 大 括号 形式 〈{{ }}) 是 Django 模板 语言 中 的 属性 访问 语法 ， 采 用 英文 名 
点 的 方式 访问 变量 的 属性 ， 如 上 面 示例 中 的 代码 (( question.question text }}, EP question 
是 视图 通过 字典 形式 传递 给 模板 的 变量 ， 通过“.” 访 问 question 的 属性 。 

模板 中 {% %} 形式 的 代码 是 Django 模板 语言 的 函数 语法 ， 上 例 中 (96 for choice in 
question.choice_set.all %} 是 一 个 for 循环 ， 循 环 对 象 是 question.choice_set.all， 该 对 象 等 价 于 
Python 语法 中 的 question.choice_set.all0)， 返 回 一 个 可 遍历 的 数组 。Django 模板 函数 需要 结 
RERE, RAP {% for %} 循环 的 结束 标记 是 {% endfor %}。 


14.11.2 ”模板 中 的 超 链接 


面 我 们 使 用 硬 编码 的 形式 ， 在 polls/index.html 模板 中 编写 HTML 超 链 接 : 


前 


<a href="/polls/{{ question.id }}/">{{ question.question text }}</a> 

当 项 目 中 存在 很 多 模板 并 且 多 个 模板 都 使 用 了 同一 个 URL 的 时 候 ， 如 果 需 要 修改 URL, 
那么 这 种 URL 的 书写 方式 会 给 开发 人 员 带 来 很 大 的 工作 量 。 此 时 可 以 通过 对 URL 命名 的 方 
式 解决 这 类 问题 ， 前 面 在 介绍 URL 时 讲 到 了 URL 的 命名 ， 本 例 中 的 URL 如 下 : 


path('«int:question id>/', views.detail, name-'detail') 

使 用 URL 名 字 重 新 修改 模板 如 下 : 

«a href-"($ url 'detail' question.id $)"»(( question.question text }}</a> 

其 中 (96 url 96) 是 Django 的 模板 标签 ， 用 于 定义 URL。 该 标签 将 会 在 polls/urls 模块 中 
查找 名 为 detail 的 URL, question.id 作为 参数 传递 给 URL， 如 果 需 要 传递 多 个 参数 ， 只 要 在 
question.id 后 面 紧 跟 一 个 空格 然后 继续 添加 参数 即 可 。 
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通过 使 用 (96 url 96) 模板 标签 可 以 快速 修改 模板 中 的 URL， 极 大 地 提高 工作 效率 保证 代 
码 安全 。 


14.11.3 ”为 超 链 接 添加 命名 空间 


命名 空间 可 以 有 效 地 对 变量 进行 隔离 ， 防 止 名 称 相同 的 变量 之 间 调 用 混乱 的 问题 。 
Django 中 可 以 为 URL 定义 命名 空间 。 试 想 一 下 ， 在 真实 项 目 中 往往 会 存在 很 多 应 用 程序 ， 
而 不 同 应 用 程序 之 间 可 能 存在 同名 的 视图 ， 如 多 个 应 用 中 都 存在 detail 视图 ,那么 在 {% url 
%} 标签 中 如 何 确定 应 该 调用 哪 一 个 应 用 中 的 URL 呢 ? 此 时 可 以 通过 为 URL 添加 命名 空间 
的 方式 解决 以 上 问题 。 

打开 polls/urls.py 文件 ， 在 其 中 添加 app. name 变量 来 设置 URLconf 的 命名 空间 ， 修 改 
后 的 代码 如 下 : 


接 下 来 修改 polls/index.html 模板 中 的 URL, X detail 视图 添加 命名 空间 
| <a href="{$ url 'polls:detail" question.id %)">({ question.question text }}</a> 


此 时 单 击 index 页 面 中 的 超 链 接 的 话 仍 能 正常 显示 。 


| 14.12 | HTML 表单 


我 们 讲解 HTML 表单 在 Django 中 的 应 用 之 前 ， 先 进行 必要 的 准备 工作 。 
将 Choice 模型 注册 到 admin 网 站 ， 修 改 polls/admin.py: 
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登录 admin 后 台 ， 为 问卷 添加 选项 : 单 击 “ 增 加 ”按钮 ， 进 入 添加 问卷 选项 页 面 ， 如 
图 14-17 所 示 。 


站 点 管理 

POLLS 

Choices 十 增加 ££ 
Questions 十 增加 Aik 
MEER 

用 户 十 增加 6m 
组 二 增加。 6 


14-17 
添加 三 个 选项 ， 如 图 14-18 所 示 。 


增加 choice 
Question: | Question obier "| 2 + 
— 
Votes o 
增加 choice 
ba [ Quesienctje() "| 7 + 
Choice text: 不 喜欢 
Votes: |o | 
增加 choice 
Question: Question object (1) Y | > + 
Choice text- 不 知道 
Votes: |o 


14-18 
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完成 准备 工作 后 ， 继 续 修改 polls/detail.html 模板 ， 为 其 添加 HTML 表单 用 于 提交 信息 ， 
新 模板 如 下 : 


以 上 模板 简单 介绍 如 下 : 

O 在 问卷 页 显示 问卷 相关 选项 ， 并 为 每 一 个 选项 添加 单 选 按钮 (radio). 

O 表单 的 处 理 页 用 url 模板 标签 表示 "{% url 'polls:vote' question.id %}", 表单 以 post 的 
方式 提交 。 

口 forloop.counter 标签 用 于 记录 循环 次 数 。 

O 由 于 当前 表单 使 用 post 方式 提交 数据 ， 我 们 需要 防止 伪造 的 跨 域 请 求 ， 表 单 中 的 {% 
csrf token 96) 标签 就 可 以 解决 这 类 问题 。 

接 下 来 创建 一 个 视图 来 接收 并 处 理 表 单 提交 信息 : 
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对 以 上 视图 做 简单 介绍 如 下 : 

( 1) requestPOST['choice'] : POST 提交 数据 是 一 个 字典 ， 因 此 该 语句 表示 在 提交 信息 检 
索 choice 值 。 如 果 表 单 提交 信息 中 不 存在 choice 则 抛 出 KeyError。 

(2) 信息 处 理 结束 后 ， 使 用 HtpResponseRedirect 方法 跳 转 到 新 的 页 面 以 免 用 户 单 击 浏 
览 器 后 退 按钮 重新 提交 表单 。 

(3 ) 为 了 防止 在 HttpResponseRedirect 方法 中 使 用 URL 硬 编码 ， 使 用 reverse0 方法 强制 
调用 URL 名， 而 不 是 直接 使 用 URL。 

修改 results 视图 : 


新 建 polls/results.html 模板 并 添加 以 下 代码 : 


到 目前 为 止 ， 一 个 简单 的 投票 系统 就 做 好 了 ， 登 录 网 站 测试 一 下 。 
打开 投票 系统 http://127.0.0.1:8000/polls/， 如 图 14-19 所 示 。 


吾 楼 一面 对 
€ Q 9- O http//127.0.0.1:8000/polls/ t- do 
| © / D Peeu220038000- x (E 

* 你 喜欢 Diango 吗 ? 


图 14-19 
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单 击 问卷 链接 ， 打 开 如 图 14-20 所 示 的 界面 。 


29e -0 x 
€ Q 9- Qntp//1270018000/polls/1/ sve- EEEN 
€ / D http//127.0.0.1:8000/F x | + 
你 喜欢 Django 吗 ? 

喜欢 
o REX 
9 不 知道 
提交 
图 14-20 


选择 任意 选项 ， 单 击 “ 提 交 ” 按 钮 ， 打 开 如 图 14-21 所 示 的 界面 


=0 -o0 x 
€ Q 9- @ http//127.0.0.1:8000/polls/1/results/ $ Yr ~ Xe Yt 
€ / D htp//127.00.:8000/. x \ + 
你 喜欢 Django 吗 ? 

。 喜欢 一 计 票 1 次 


* 不 喜欢 一 计 票 0 s 次 
。 不 知道 一 计 票 0 s 次 


重新 投票 ? 


图 14-21 


通用 视图 系统 


回顾 前 面 的 代码 可 以 发 现 ，detail0 和 results0 两 个 视图 结构 非常 相似 ， 都 是 根据 视图 参 
数 从 数据 库 中 提取 相应 数据 并 演 染 模板 。 不 仅 这 两 个 视图 ， 在 真实 项 目 中 会 存在 很 多 结构 相 
似 的 视图 ， 据 此 Django 提供 了 一 个 通用 视图 系统 (generic views system)， 通 过 通用 视图 系统 
开发 人 员 甚至 可 以 在 不 编写 任何 Python 代码 的 情况 下 就 可 以 完成 一 个 应 用 程序 。 

下 面 使 用 通用 视图 系统 对 polls 应 用 进行 改进 。 


14.13.1 修改 URLconf 


打开 polls/urls.py 文件 ， 使 用 下 面 代码 重新 定义 URL: 
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注意 detail 和 results 两 个 URL 的 匹配 字符 串 中 «question id> 被 替换 为 了 <pk>， 同 时 第 
二 个 参数 多 了 一 个 as_view() 方法 。 


14.13.2 ”修改 视图 


打开 polls/views.py 脚本 文件 ， 删 除 已 有 的 index, detail, results 视图 并 添加 以 下 代码 ( 保 
持 vote 视图 不 变 ); 
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代码 解析 : 
在 新 视图 中 ， 我 们 使 用 了 两 个 通用 视图 : ListView 和 DetailView。 这 两 个 视图 分 别 用 于 
“显示 一 组 对 象 ”和 “显示 一 个 特定 对 象 的 详细 信息 ”。 使 用 通用 视图 时 需要 注意 : 
口 每 一 个 通用 视图 都 需要 指定 待 解析 的 模型 ; 
口 DetailView 需要 从 URL 中 获取 模型 的 主键 值 ， 因 此 在 URL 定义 中 我 们 将 question id 
修改 为 pk。 
为 通用 视图 指定 模板 : 

O 默认 情况 下 ，DetailView 会 调用 一 个 名 字 格 式 为 <appname>/<modelname> detail.html 的 
视图 。 由 于 polls 中 创建 了 新 视图 ， 所 以 需要 使 用 template_name 属性 重新 指定 模板 。 
口 与 DetailView 相似，ListView 也 存在 一 个 默认 模板 ,默认 模板 的 名 字 格 式 为 

<appname>/<modelname> list.html， 使 用 template name 重新 指定 模板 。 
为 通用 视图 传递 上 下 文 对 象 : 
前 面 我 们 使 用 一 个 字典 对 象 为 模板 传递 上 下 文 对 象 ， 而 对 于 DetailView 来 说 ， 我 们 什么 都 
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不 需要 做 ，Django 会 根据 URL 传递 的 主键 值 以 及 模型 自动 生成 一 个 上 下 文 对 象 并 传递 给 模板 ， 
本 例 中 自动 生成 的 上 下 文 对 象 为 question ; 对 于 ListView Xi, Django 会 根据 模型 自动 生成 一 
个 包含 所 有 模型 数据 的 上 下 文 对 象 并 传递 给 视图 ， 本 例 只 需要 提取 最 新 发 布 的 5 条 文件 ， 因 此 
使 用 context object name 重 写 上 下 文 对 象 名 并 用 get. queryset(self) 方法 取得 最 新 的 5 条 问卷 。 


I 自动 化 测试 


任何 软件 产品 在 发 布 之 前 都 应 该 完成 测试 工作 ， 充 分 合理 的 测试 工作 可 以 保证 产品 中 
的 缺陷 能 够 在 产品 发 布 前 被 发 现 并 得 到 解决 ， 继 而 提高 产品 质量 。 现 代 软件 产品 的 规模 越 来 
越 庞 大 、 业 务 迎 辑 越 来 越 复杂 、 发 布 周期 越 来 越 短 ， 如 果 仅 仅 使 用 人 工 测试 的 话 ， 会 带 来 
大 的 工作 量 以 及 人 工 成 本 。 自 动 化 测试 就 是 通过 编写 自动 化 测试 脚本 的 方式 ， 让 机 器 完成 简 
单 、 常 规 的 测试 工作 ， 而 测试 人 员 只 需要 关注 于 产品 中 的 新 功能 即 可 。 


m 


14.14.11 编写 第 一 个 测试 用 例 


Question 模型 包含 一 个 方法 was_published_recently( 用 于 判断 问卷 是 不 是 最 近 一 天 发 布 
的 ， 如 果 问 卷 是 一 天 内 发 布 的 ， 该 方法 返回 True, 但 是 如 果 问 卷 的 发 布 日 期 是 未 来 的 某 一 个 
日 期 的 话 ，was_published_recently() 仍然 会 返回 True， 这 是 不 正确 的 。 下 面 我 们 就 来 编写 一 
个 测试 用 例 来 验证 发 布 日 期 是 否 正确 。 

Django 的 自动 化 测试 代码 通常 会 放 在 一 个 以 test 开头 的 Python 脚本 文件 中 ，Dijango 系 
统 也 会 根据 文件 名 来 查找 测试 代码 。 在 使 用 Django 命令 行 创建 应 用 程序 的 时 候 ， 系 统 已 经 
为 我 们 创建 了 一 个 叫 作 tests.py 的 自动 化 测试 脚本 文件 。 

将 以 下 测试 代码 复制 到 polls\ tests.py 脚本 中 : 


#!/usr/bin/python 
do coding: /UPRE=8 —*= 


import datetime 


from django.utils import timezone 
from django.test import TestCase 


from .models import Question 
class QuestionModelTests (TestCase): 
def test was published recently with future question(self): 


当 问 卷 的 发 布 日 期 是 未 来 的 某 一 天 时 ，was_Published recently() 方法 将 会 返回 False。 
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time = timezone.now() + datetime.timedelta (days-30) 
future question = Question(pub date-time) 
self.assertIs(future question.was published recently(), False) 


14.14.2 ”执行 测试 用 例 


E 命 令 行 提 示 符 窗口 执行 以 下 代码 : 


$ python manage.py test polls 


命令 执行 结果 如 图 14-22 所 示 


图 14-22 


命令 解析 : 

O python manage.py test polls 检索 应 用 程序 polls 中 的 全 部 测试 用 例 ; 

O 如 果 发 现 自动 化 测试 类 (django.test.TestCase 的 子 类 )， 创 建 一 个 测试 数据 库 ; 
口 检索 测试 方法 (测试 方法 名 以 test 开头 ); 

口 执行 测试 方法 并 输出 测试 结果 ; 

口 删除 测试 数据 库 


14.14.3 ”修改 代码 中 的 bug 


我 们 需要 修改 已 经 找到 的 代码 中 存在 的 bug， 在 前 面 代 码 中 如 果 问 卷 的 发 布 日 期 是 将 来 
下 : 只 有 一 天 内 发 布 的 问 


的 某 一 天 ，was_published_ recently() 方法 会 返回 False， 对 其 修改 如 1 
卷 才 属 于 “最 近 发 布 的 问卷 "， 此 时 was published recently() 方法 返回 True: 
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def was published recently (self): 
now = timezone.now() 
return now - datetime.timedelta(days-1) <= self.pub date <= now 


重新 执行 测试 用 例 ， 如 图 14-23 所 示 


[ 管理 员 : 命令 提示 符 


est in 0.005 


: Django deno ny 


图 14-23 


14.14.4 边界 值 测试 


边界 值 测试 是 用 来 测试 用 户 输入 边界 值 时 代码 功能 是 否 正常 的 一 种 测试 方式 ， 边 界 值 也 
经 常 出 现 软件 执行 异常 的 情况 

前 面 我 们 将 当前 时 间 与 前 一 天 之 间 所 发 布 的 问卷 定义 为 “最 近 发 布 的 问卷 "， 那 么 它 的 
边界 值 就 是 “ 比 前 一 天 早 一 秒 钟 ” 和 “上 比 前 一 天 晚 一 秒 钟 "， 据 此 添加 两 个 新 的 测试 用 例 : 


def test was published recently with old question(self) : 
"nn 


当 间 卷 的 发 布 日 期 比 前 一 天 还 早 一 秒 钟 时 ，was_published recently() 返回 False. 


"nn 
time = timezone.now() - datetime.timedelta(days-1l, seconds-1) 
old question - Question(pub date-time) 
self.assertIs(old question.was published recently(), False) 


def test was published recently with recent question (self): 


当 问 卷 的 发 布 日 期 比 前 一 天 晚 一 秒 钟 时 ，was_published_recently() 返回 True。 


time = timezone.now() - datetime.timedelta (hours=23, minutes-59, seconds=59) 
recent question = Question(pub date-time) 
self.assertIs(recent question.was published recently(), True) 


14.44.5 ”测试 自 定义 视图 


目前 polls 应 用 程序 可 以 使 用 任何 pub. date 来 发 布 问卷 ， 甚 至 使 用 未 来 的 某 一 天 。 为 了 
解决 这 一 问题 ， 将 问卷 的 显示 逻辑 修改 为 : 如 果 问 卷 的 发 布 日 期 还 没 到 ， 则 问卷 不 可 见 。 修 
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改 mdexView 视图 的 get. queryset) 方法 。 
添加 timezone 引用 : 


根据 发 布 日 期 过 滤 Question: 


为 了 对 新 视图 进行 测试 ， 我 们 需要 分 别 创建 : 发 布 日 期 早 于 当前 时 间 的 问卷 、 发 布 日 期 
晚 于 当前 时 间 的 问卷 、 多 种 发 表 时 间 混 合 的 问卷 。 
修改 polls tests.py 脚本 ， 添 加 create. questionQ 用 于 创建 测试 问卷 : 


添加 测试 用 例 ， 为 了 模拟 浏览 器 访问 引用 程序 ， 我 们 使 用 Django 控制 台 (shell) 中 的 
client 对 象 完成 测试 代码 : 
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14.14.6 ”测试 DetailView 


虽然 在 index 视图 中 限制 了 问卷 的 显示 规则 ， 但 是 如 果 用 户 知道 或 者 根据 一 定 的 规律 猜 
到 了 问卷 的 ID ， 那 么 就 可 以 通过 这 个 ID 访问 问卷 的 详细 信息 。 为 了 解决 这 个 问题 ， 可 以 按 
照 下 面 方式 修改 DetailView。 
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与 DetailView 相似 ，ResultsView 也 可 以 按照 上 面 方法 添加 get. queryset 和 测试 类 。 另 
外 ， 对 于 还 没有 选项 的 问卷 ， 不 应 该 显示 在 index 页 面 和 result 页 面 。 针 对 这 些 规 则 可 以 添 
加 更 多 的 测试 用 例 。 

对 于 不 同 权限 的 用 户 ，index 页 面 所 显示 的 信息 也 可 能 不 同 ， 这 些 都 可 以 编写 自动 化 测 
试用 例 。 

建议 开发 人 员 每 完成 一 个 新 的 功能 都 要 编写 相应 的 自动 化 测试 用 例 。 

下 面 是 一 些 测 试用 例 的 最 佳 实践 : 

口 为 每 一 个 模型 或 视图 单独 创建 测试 类 。 

口 每 一 个 测试 用 例 只 用 来 测试 一 种 情况 。 

口 测试 用 例 名 要 能 够 解释 用 例 。 


EA 添加 css 样式 


目前 我 们 已 经 完成 了 调查 问卷 系统 的 主要 功能 ， 但 是 还 没有 使 用 CSS 样式 对 其 进行 美 
化 ， 本 节 将 带领 读者 学 习 如 何在 Django 应 用 中 使 用 Css 样式 。 
Django 将 图 片 、JavaScript、CSS 等 文件 称 为 静态 文件 (static file)。 对 于 小 项 目 来 说 ， 
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如 何 处 理 静 态 文件 不 是 太 重 要 的 事情 ， 我 们 可 以 将 它们 放 在 任何 地 方 ， 只 要 服务 器 能 访问 到 
就 可 以 了 。 但 是 对 于 大 项 目 来 说 ,尤其 是 包含 了 很 多 应 用 程序 的 项 目 ， 人 处理 每 一 个 项 目 所 使 
用 的 静态 文件 就 比较 困难 了 。 

默认 情况 下 ，Dijango 会 在 应 用 程序 根 目录 下 查找 static 文件 夹 ， 这 个 文件 夹 就 是 用 来 存 
放 静 态 文件 的 。 

按照 路 径 polls/static/polls/style.css 创建 一 个 style.css 样式 文件 ， 具 体 CSS 内 容 如 下 : 


接 下 来 修改 模板 polls/templates/polls/index.html， 在 模板 最 顶部 添加 以 下 代码 : 


到 此 为 止 ， 所 有 关于 CSS 的 设置 已 经 完成 ， 重 启 Web 服务 ， 然 后 在 浏览 器 中 打开 index 
页 面 ， 如 图 14-24 所 示 。 


mu -0x 
€ © 9- Q httpy/127.0.0.1:8000/polls/ ft- xd 


C j D Pp/270018000- x |. 


14-24 
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自 定义 后 台 管 理 页 面 


前 面 介绍 过 如 何 使 用 admin.site.registerO 方法 向 Admin 后 台 程 序 添加 模型 。 不 仅 如 此 ， 
Django 还 允许 我 们 对 Admin 后 台 进行 更 丰富 的 定制 化 操作 。 


14.16.1 ”对 模型 属性 进行 分 组 显示 


修改 polls/admin.py 文件 : 


打开 浏览 器 查看 显示 效果 ， 如 图 14-25 所 示 。 


= 
€ © SH. Q2 001899247in/polls/auestion/i/change/. Ro 

Ó T D BA I ME 

修改 question e 
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Date putises- B: xumme | sei 
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(e CZB ET ES 
图 14-25 


14.16.2 添加 相关 模型 


在 添加 新 问卷 的 时 候 ， 我 们 希望 能 够 同时 为 问卷 添加 选项 。 用 以 下 代码 替换 polls/admin. 
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py 脚本 中 原 有 的 代码 : 


上 面 代码 使 管理 员 能 够 在 添加 Question 的 同时 编辑 Choice 对 象 ， 默 认 情 况 下 需要 为 
Question 提供 两 个 选项 。 


重新 打开 Question 管理 页 面 ， 效 果 如 图 14-26 所 示 。 


€ Q D | O ntp//1270018000/admivpollyaueston/add/ ta- 之 家 | 


Q DB sn queson | lang x t 
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对 于 新 闻 卷 ， 在 问卷 中 添加 页 面包 含 两 个 Choice 选项 ， 而 如 果 编 辑 一 个 已 经 存在 的 问 
卷 ， 则 会 出 现 两 个 新 的 Choice 选项 供 管理 员 为 问卷 添加 选项 ， 如 图 14-27 所 示 。 
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€ © 9- Qrp/1210018000/simir/pclis/3uestion/t [change]. 
O | D ma ern oro x CR 


Quesionter: resina? 


14-27 
在 问卷 选项 的 最 后 有 一 个 链接 用 于 继续 添加 新 选项 。 


在 这 里 ， 读 者 可 能 会 发 现 一 个 问题 ， 如 果 一 个 问卷 包含 了 很 多 选项 ， 这 些 选 项 会 占用 大 


量 的 页 面 空间 ， 很 不 方便 管理 ， 对 此 ，Diango 提供 了 一 种 新 的 显示 视图 admin. TabularInline , 
修改 ChoicelInline: 


刷新 页 面 查看 现在 的 显示 样式 ， 如 图 14-28 所 示 。 


i 


图 14-28 
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14.16.3 ”定制 模型 显示 列表 


现 有 的 模型 显示 列表 如 图 14-29 所 示 。 


F 
€ Q 9- Qntp//1270018000/2ámin/polis/auestion/ f*- 
O DEE queson ksa] < + 


EE question 来 修改 


ar J ig onii 
uso 
你 喜欢 Dango 四 9 
pes 
图 14-29 


默认 情况 下 ，Django 只 显示 每 行 数据 的 strO0， 但 是 更 多 的 情况 是 ， 我 们 需要 显示 更 多 信 


. 使 用 list_display 属性 修改 QuestionAdmin 25: 


class QuestionAdmin (admin.ModelAdmin): 
list display - ('question text', 'pub date', 'was published recently') 


# 对 字段 进行 分 组 
fieldsets = [ 
(None, ['fields': ['question text']]), 


('Date information', [('fields': ['pub date']]), 
] 


inlines = [ChoiceInline] 


EJA Web 服务 ， 查 看 Question 模型 显示 列表 ， 如 图 14-30 所 示 。 


eN 


oen 
€ Q 9- Q nazon oami pots question] IB 


模型 显示 列表 是 可 排序 列表 ， 我们 可 以 通过 单 击 QUESTION TEST fü DATE 
PUBLICHED 列 标题 对 表格 进行 排序 。 
Django 不 支持 对 方法 输出 列 进 行 排序 。 
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使 用 list_filter 属性 设置 可 过 滤 列 。 
在 QuestionAdmin 类 添加 代码 : list filter = [pub date'], EJA Web 服务 查看 页 面 显示 结 


果 ， 如 图 14-31 所 示 。 


€ © 5- |O no/17:01899/s npo 


图 14-31 


使 用 search fields 属性 为 列表 添加 可 搜索 字段 。 
在 QuestionAdmin 类 添加 代码 :; search fields = ['question text] ， 重 启 Web 服务 查看 页 


面 显示 结果 ， 如 图 14-32 所 示 。 


€ © D- O me/nz0012000/ric/pci quein Ta 8 
O D II 
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14.16.4 E$] Admin 后 台 模 板 
浏览 整个 Admin 后 台 网 页 会 发 现 ， 每 个 页 面 左 上 角 都 会 出 现 “ Django 管理 ”字样 ， 这 
是 由 Django 的 模板 系统 提供 的 ,我们 可 以 对 其 进行 修改 。 
C1) 在 工程 文件 夹 (manage.py 所 在 文件 夹 ) 创建 一 个 templates 文件 夹 。 
( 2) 在 mysite/settings.py 中 找到 TEMPLATES 设置 项 ， 添 加 DIRS 选项 : 


TEMPLATES = [ 
t 
'BACKEND': 'django.template.backends.django.DjangoTemplates', 
'DIRS': [os.path.join(BASE DIR, 'templates'), 
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(3) TE mysite/templates 文件 夹 下 创建 admin 文件 夹 。 
(4) 将 Django 自 带 的 admin/base_site.html 模板 复制 到 mysite/templates/admin。 
通过 以 下 命令 可 以 快速 查找 Django 自 带 的 admin/base_site.html 模板 路 径 : 


(5 ) 修改 mysite/templates/admin/base_site.html: 


修改 完成 重启 Web 服务 ， 查 看 Admin 管理 页 面 ， 如 图 14-33 所 示 。 


€ Q 5- 9 unmoarsxo ai; sa- *£$* 


QS uesel mt x t 


14-33 
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小 结 


到 目前 为 止 ， 我 们 已 经 介绍 完 所 有 的 人 门 教程 ， 包 括 安装 Django 和 配置 Django 开发 
环境 ， 创 建 Django 工程 和 应 用 ,配置 数据 库 ， 开 发 视图 和 模板 并 使 用 CSS 样式 对 模板 进 
行 美化 。 

此 时 读者 应 该 能 够 独立 搭建 Web 应 用 了 ， 但 是 如 果 想 要 更 愉快 地 使 用 Django， 我 们 还 


仅 占 Django 全 部 知识 体系 的 5%。 虽 然 前 面 的 内 容 并 不 丰富 ， 但 却 是 最 基础 的 部 分 ， 建 议 所 
有 读者 在 继续 后 面 章节 的 学 习 之 前 一 定 要 完成 本 章 内 容 的 学 习 与 实践 。 


第 15 章 
Django 知识 体系 


任何 一 门 技术 都 有 它 的 知识 体系 ， 想 要 学 好 Django， 就 必须 先 在 头脑 中 对 它 的 知识 体系 
有 一 个 清晰 的 认识 ， 当 我 们 能 够 了 解 这 个 体系 中 的 每 一 个 知识 点 时 ， 即 使 不 能 够 深刻 地 理解 
它 ， 也 能 够 在 遇 到 困难 时 迅速 定位 到 问题 根源 。 


Socket 编程 


Socket 也 叫 “ 套 接 字 ”， 是 计算 机 网 络 通信 中 最 基础 的 内 容 ， 它 通过 对 TCP/IP 协议 的 封 
装 提供 了 在 不 同 主机 之 间 进 行 通信 的 功能 。 当 我 们 访问 一 个 网 站 时 ， 浏 览 器 会 为 我 们 打开 一 
个 套 接 字 ， 通 过 套 接 字 建 立 与 服务 器 之 间 的 链接 ， 链 接 建立 成 功 后 服务 器 提供 对 访问 的 响应 
并 返回 访问 内 容 ， 浏 览 器 接收 响应 并 显示 出 来 。 

我 们 接触 到 的 所 有 Web 应 用 几乎 都 是 通过 Socket 实现 的 ， 一 个 网 站 本 质 上 就 是 一 个 
Socket 服务 端 和 客户 端 之 间 的 通信 ，Web 服务 器 就 是 服务 端 而 用 户 浏 览 器 就 是 客户 端 。 用 户 
访问 网 站 的 过 程 就 是 服务 端 与 客户 端 Socket 通信 的 过 程 ， 如 图 15-1 所 示 。 


服务 器 端 客户 端 


图 15-1 
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下 面 程序 代码 是 一 个 简单 的 socket web 服务 器 ， 当 程序 执行 起 来 之 后 通过 浏览 器 访问 
http://localhost:8000/， 就 会 打开 一 个 Hello, World! 的 页 面 : 


浏览 器 访问 效果 如 图 15-2 所 示 。 


| 
€ © 9- Q9 ntp//12700.:8000/ 5 *t - [EE 


合 / D 该 网 页 无 法 访问 x a 


Hello, World! 


15-2 
这 就 是 所 有 网 站 的 实现 原理 : 接收 HTTP 请 求 、 解 析 HTTP 请 求 ， 发 送 HTTP 响应 。 如 
果 这 些 工作 都 由 网 站 开发 人 员 来 做 的 话 ， 那 么 开发 人 员 不 仅 需要 熟悉 自身 产品 相关 的 技术 ， 
还 需要 学 习 HTTP 协议 、TCP/IP 协议 等 ， 这 会 带 来 很 多 额外 的 工作 量 。 幸 运 的 是 ， 这些 工作 
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已 经 有 人 帮 有 我们 完成 了 ， 在 Python 中 这 个 工作 就 是 由 WSGI 接 口 实现 的 ，Django 基于 WSGI 
接口 。 

当 访 问 同一 个 网 站 时 ， 如 果 输 入 的 URL 地 址 不 同 ， 网 页 显示 内 容 也 不 相同 ， 这 就 是 一 
般 Web 框架 所 实现 的 ， 下 面 开 发 一 个 可 以 根据 用 户 输入 地 址 的 不 同 而 显示 不 同 页 面 信息 的 
Web 框架 。 这 个 框架 可 以 接收 两 个 地 址 : index 和 detail， 对 于 输入 其 他 地 址 则 返回 404 错误 ， 
具体 代码 如 下 : 


执行 脚本 ， 然 后 分 别 访问 index, detail 和 home 页 面 ， 如 图 15-3 所 示 。 

虽然 这 个 Web 框架 看 起 来 非常 简单 ， 但 是 事实 上 很 多 开发 框架 都 是 这 样 在 WSGI 基础 
上 开发 来 的 ， 只 是 不 同 的 框架 提供 了 不 同 的 功能 而 已 。 感 兴趣 的 同学 可 以 尝试 自己 开发 一 套 
Web 框架 。 
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E 
€ © 9- O http//1270.01:8000/index tr- tA 
Q / D httpy/127.0.0.1:8000/: x * 

这 里 是 Index 页 面 
(a) 

三 他 = ux 
€ © O- Q ntp//12700.18000/detail x xd 
eo D) http://127.0.0.1:8000/- x * 

这 里 是 Detail 页 面 
(b) 

本 
€ Q 9- 日 httpy/1270018000/home fa- ox 
o J http://127.0.0.1:8000/h x 
网 页 丢失 了 : 404 


(c) 


图 15-3 


A MTV tex 


TR 


前 面 的 Web 开发 框架 过 于 简单 ， 完 全 属 了 


FA tf AI 


F 初 级 程序 员 那 种 想到 哪 做 到 哪 的 开发 风格 ， 这 


发 或 者 微型 团队 开发 中 不 会 出 现任 何 问题 ， 有 时 还 能 够 提高 沟通 效率 、 
减少 工作 量 ， 但 是 当 团队 规模 扩大 、 业 务 场景 变 得 越 来 越 复杂 的 情况 下 ， 这 种 开发 模式 就 会 
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给 开发 人 员 和 技术 管理 人 员 带 来 诸多 麻烦 ， 有 时 某 一 个 开发 人 员 辛 辛苦 若 完 成 一 个 方法 后 却 
发 现 其 他 人 在 很 早 之 前 就 已 经 完成 了 ， 而 有 的 时 候 一 个 非常 高 效 的 方法 却 没有 人 知道 放 在 哪 
里 ,最 终 代码 变 得 杂乱 无 章 难以 管理 。 为 了 解决 这 些 问 题 ， 软 件 开发 中 逐渐 引入 了 开发 框架 
的 概念 ， 开 发 框架 通常 针对 某 一 领域 使 得 代码 更 容易 被 重用 。 经 常 被 提 及 的 设计 模式 有 微软 
的 ASPNET MVC 框架 、Java 的 Spring 框架 等 

Django 框架 的 基础 是 MTV 模式 ， 它 将 开发 任务 分 为 三 大 部 分 : Model, Template, 
View， 如 图 15-4 所 示 。 可 能 很 多 人 对 MTV 不 太 了 解 ， 但 是 都 对 MVC duc m 
MVC 模式 就 是 把 Web 应 用 分 为 Model (模型 )、View (视图 )、Controller (控制 器 ) 

O Model: 负责 业务 对 象 与 数据 库 的 关系 映射 (一 般 基 于 ORM 框架 )。 

O View: 负责 页 面 展 示 ， 也 就 是 与 用 户 直接 交互 的 网 页 部 分 。 

O Controller: 接收 并 处 理 用 户 的 请 求 ， 通 常 需要 调用 Model 和 View 来 完成 用 户 请 求 。 


H 响应 
2t MAER HMHR 


图 15-4 


MTV 5 MVC 模式 非常 相似 ， 也 将 开发 工作 分 为 三 层 。 


口 M 模型 ( Mode) : 负责 业务 对 象 和 数据 库 的 关系 映射 (ORM), 3x5 MVC 模式 中 的 
模型 是 一 样 的 。 

口 T 代 表 模 板 (Template) : 负责 如 何 把 页 面 展 示 给 用 户 ( html)， 这 部 分 类 似 于 MVC 中 
的 视图 。 


口 V 代表 视图 (View): 负责 业务 逻辑 ， 并 在 适当 时 候 调 用 Model 和 Template， 这 里 就 
不 是 MVC 的 View 了 ， 反 而 更 像 是 Controller. 
Django 的 响应 模式 如 图 15-5 所 示 。 
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图 15-5 


响应 顺序 如 下 : 

C1) Django 中 间 件 收 到 一 个 用 户 请 求 。 

( 2) Django 通过 URLconf 查找 对 应 的 视图 然后 进行 URL 路 由 分 发 。 
(3 ) 视图 接收 到 请 求 ， 查 询 对 应 的 模型 ， 调 用 模板 生成 HTML。 
( 
( 


4 ) 视图 返回 一 个 处 理 后 的 HTML 内 容 。 
5) Web 服务 器 将 响应 内 容 发 给 客户 端 。 


Django 知识 体系 概述 


前 面 介绍 了 一 般 Web 开发 框架 的 工作 原理 以 及 Django 的 工作 流程 ， 结 合 前 一 章 所 讲 内 
容 ， 此 时 在 读者 头脑 中 应 该 对 Django 的 知识 体系 有 一 个 比较 清晰 的 认识 了 。 本 节 将 会 对 这 
些 Django 的 关键 知识 点 进行 简单 介绍 ， 以 帮助 读者 在 进行 后 续 学 习 时 能 够 有 一 定 的 基础 。 

口 配置 信息 。 在 搭建 第 一 个 Django 网 站 时 ， 我 们 多 次 提 到 了 settings.py XF, Django 
网 站 的 所 有 配置 信息 都 是 在 这 里 完成 的 。 

口 路 由 系统 。 路 由 系统 是 对 用 户 请 求 的 分 发 ，Django 通过 URLconf 模块 使 开发 人 员 可 
以 开发 出 简洁 优雅 的 URL 格式 。 

口 模型 。 模 型 是 数据 库 的 映射 ， 通 过 ORM 技术 开发 人 员 可 以 使 用 纯粹 的 Python 语言 来 
定义 数据 库 模 型 ， 这 是 一 个 丰富 的 、 动 态 的 数据 库 访 问 接口 ， 当 然 在 必要 的 情况 下 ， 
读者 仍然 可 以 写 SQL 脚本 来 处 理 自己 的 业务 逻辑 。 

口 模板 。 模 板 是 Django 应 用 程序 的 表现 层 ，Django 通过 友好 的 信息 展示 语法 为 用 户 提 

供 了 网 页 绘制 功能 ， 这 些 语 法 不 仅 包括 丰富 的 模板 过 滤器 与 标签 ， 还 允许 开发 人 员 
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发 自己 的 过 滤器 和 标签 。 

O 视图 。Django 的 视图 可 以 接收 用 户 请 求 并 进行 相应 的 业务 实现 ， 最 后 调用 恰当 的 模板 
对 用 户 进行 响应 。 

口 表单 系统 。Web 应 用 程序 中 客户 端 与 服务 器 端 进行 交互 的 一 个 重要 概念 就 是 HTML 


表单 ，Django 提供 了 一 个 强大 的 表单 系统 可 以 使 开发 人 员 简 单 地 创建 表单 、 处 理 表单 
数据 。 

O Admin 管理 模块 。Django 的 Admin 管理 模块 完全 可 以 称 作 是 一 个 CMS 系统 了 ,通过 
丰富 的 接口 ， 开 发 人 员 可 以 在 编写 很 少 代 码 的 情况 下 快速 搭建 起 一 套 包含 信息 发 布 、 
权限 管理 等 功能 的 应 用 系统 。 


(15.4 | django-admin fil manage.py 


django-admin 是 Django 的 命令 行 工具 集 ， 用 于 处 理 系 统管 理 员 相 关 操作 ， 而 manage.py 
是 在 创建 Django 工程 的 时 候 自 动 生成 的 ， 二 者 的 作用 完全 一 样 。 

在 使 用 时 需要 注意 的 是 ，django-admin 存放 在 python 的 site-packages/django/bin 目录 ， 
而 manage.py 存放 在 工程 文件 夹 下 。django-admin 可 以 对 不 同 的 项 目 进 行 设置 ， 但 是 需要 提 
前 指定 settings.py 文件 ， 而 manage.py 只 对 当前 工程 有 效 ， 并 且 已 经 完成 了 所 有 环境 准备 工 
作 ， 可 以 直接 拿 来 使 用 。 

下 面 是 工程 mysite 的 manage.py 脚本 内 容 : 


#!/usr/bin/env python 
import os 
import sys 


if | name  -- " main ": 
os.environ.setdefault("DJANGO SETTINGS MODULE", "mysite.settings") 
try: 


from django.core.management import execute from command line 
except ImportError as exc: 
raise ImportError( 
"Couldn't import Django. Are you sure it's installed and " 
"available on your PYTHONPATH environment variable? Did you " 
"forget to activate a virtual environment?" 
) from exc 
execute from command line (sys.argv) 


总 之 ，manage.py 比 django-admin 更 简单 ， 本 节 所 有 命令 都 可 以 使 用 managepy 蔡 代 ， 
例如 django-admin help 可 以 替换 为 python manage.py help. 
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15.4.1 help 
作用 : 取得 帮助 信息 。 
语法 如 下 。 
显示 帮助 信息 以 及 可 用 命令 : 
django-admin help 


显示 可 用 命令 列表 : 


django-admin help --commands 
显示 指定 命令 的 详细 帮助 文档 : 


django-admin help «command» 


15.4.2 version 


作用 : 取得 当前 Django 的 版 本 信息 。 


语法 : django-admin version 
15.4.3 check 


作用 : 检查 工程 中 是 否 存在 错误 。 
语法 : django-admin check [app label [app label ...]] 


15.4.4 startproject 


作用 : 创建 Django 工程 。 

语法 : django-admin startproject name [directory] 

其 他 : 命令 默认 在 当前 目录 创建 一 个 文件 夹 ， 文 件 夹 下 包含 manage.py 文件 以 及 工程 文 
件 夹 ， 在 工程 文件 夹 下 包含 settings.py 文件 和 其 他 必要 文件 。 


15.4.5 startapp 


作用 : 创建 Django 应 用 程序 。 
语法 : django-admin startapp name [directory] 
可 选 参数 : 
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--template TEMPLATE 

导入 外 部 模板 文件 ， TEMPLATE 可 以 是 包含 模板 文件 的 路 径 、 包 含 压缩 包 的 路 径 或 者 
URL. 

例如 下 面 命令 会 将 my app template 路 径 下 的 模板 文件 复制 到 myapp 应 用 程序 中 : 


django-admin startapp --template-/Users/jezdez/Code/my app template myapp 


而 下 面 命令 会 将 github 上 其 他 项 目的 模板 复制 到 myapp 应 用 中 : 


django-admin startapp --template-https://github.com/ebertti/django-registration- 
bootstrap/archive/master.zip myapp 


15.4.6 runserver 


作用 : 在 当前 机 器 上 启动 一 个 轻 量 级 的 Web 服务 器 ， 默 认 服务 器 端口 号 是 8000 
语法 : django-admin runserver [addrport] 

示例 ; 

django-admin runserver 

django-admin runserver 1.2.3.4:8000 


django-admin runserver 7000 
django-admin runserver [2001:0db8:1234:5678::9]:7000 


15.4.7 shell 


作用 : 启动 一 个 交互 窗口 。 
iik: 


django-admin shell --interface [ipython,bpython,python) 
django-admin shell --i (ipython,bpython,python] 


需要 注意 的 是 ， 默 认 情 况 下 ，Dijango 使 用 ipythonbpython 启动 交互 模式 。 需 要 使 用 pip 
安装 以 上 交互 工具 ， 例 如 安装 ipython: pip install ipython。 
示例 如 图 15-6 所 示 。 


图 15-6 


$815 29 Django 知识 体系 195 INE 


Ex Migrations 


Django 通过 Migrations 命令 将 Model 中 的 任何 修改 写 入 到 数据 库 中 ， 例 如 增加 新 模型 
修改 已 有 字段 等 。 


15.5.1 makemigrations 


作用 : 根据 model 的 变化 生成 对 应 的 python 代码 ， 该 代码 用 于 更 新 数据 库 

iik: django-admin makemigrations [app_label [app label ...]] 

如 果 没 有 填写 任何 参数 ，Django 会 检查 所 有 应 用 程序 中 的 模型 并 生成 python 脚本 ， 脚 
本 存放 在 每 个 应 用 下 面 一 个 名 为 migrations 的 文件 夹 下 ， 脚 本 名 字 类 似 0001. initial.py 格式 

示例 如 图 15-7 所 示 


图 15-7 


15.5.2 migrate 


作用 : 将 model 的 修改 应 用 到 数据 库 

语法 : django-admin migrate [app label] [migration name] 

如 果 执 行 migrate 命令 时 没有 给 出 任何 参数 ，Django 会 将 系统 中 所 有 应 用 程序 模型 的 更 
改 部 署 到 数据 库 

如 果 执 行 migrate 命令 时 指定 了 应 用 程序 名 ，Django 仅 将 指定 的 应 用 程序 nM? 
署 到 数据 库 。 注 意 如 果 该 应 用 程序 的 模型 与 其 他 应 用 程序 模型 之 间 存 在 关联 ， - 其 他 
的 应 用 程序 模型 的 修改 也 可 能 被 部 署 到 数据 库 

如 果 执 行 migrate 命令 时 同时 给 出 了 应 用 程序 名 和 migration 名 字 ， 系 统 将 会 把 数据 库 恢 
复 到 一 个 以 前 的 版 本 。 

所 有 migration 信息 保存 在 django migrations 数据 表 中 ，django_migrations 表 内 容 如 图 
15-8 所 示 。 

例如 最 后 一 次 migrate 操作 ( 003_test) 为 blog 应 用 程序 创建 了 一 个 test 数据 表 ， 此 时 执 
行 下 面 代码 将 会 撤销 最 后 一 次 操作 (0002 auto 20171221 1726 是 003_test 的 前 一 次 操作 ): 
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python manage.py migrate blog 0002 auto 20171221 1726 


err. n applied 
1 contenttypes 0001 initial 2017-12-17 13:26:19.8702 
2 auth 0001 initial 2017-12-17 13:26:25.5256 
3 admin 0001 initial 2017-12-17 13:26:26.9936 
4 admin 0002 logentry remove auto add 2017-12-17 13:26:27.0666 
5 contenttypes —— 0002 remove content type name — 2017-12-17 13:26:27.9197 
6 auth 0002 alter. permission name max lei 2017-12-17 13:26:28.4017 
7 auth 0003 alter user email max length — 2017-12-17 13:26:28.9097 
8 auth 0004 alter user username opts 2017-12-17 13:26:28.9567 
9 auth 0005 alter user last login null 2017-12-17 13:26:29.3778 
10 auth 0006 require contenttypes 0002 2017-12-17 13:26:29.4028 
11 auth 0007 alter validators add error me: 2017-12-17 13:26:29.4448 
12 auth 0008 alter user username max leng 2017-12-17 13:26:30.7939 
13 auth 0009 alter user last name max leng 2017-12-17 13:26:31.3699 
14 blog 0001 initial 2017-12-17 13:26:31.5799 
15 sessions 0001 initial 2017-12-17 13:26:31.9119 
16 polis 0001 initial 2017-12-17 13:28:27.7495 
17 blog 0002 auto 20171221 1726 2017-12-21 09:26:22.9957 
18 blog 0003 test 2017-12-22 10:08:34.1517 
图 15-8 
操作 结果 如 图 15-9 所 示 。 可 以 看 出 ， 此 时 数据 表 blog test 已 经 被 删除 了 


图 15-9 
如 果 想 撤销 所 有 数据 库 更 改 ， 使 用 zero 代替 migrationname. 
可 选 参数 : 
--fake 


对 于 高 级 用 户 ， 仅 仅 想 设置 当前 的 migration 状态 ， 并 不 需要 真正 去 更 新 数据 库 ， 或 者 
已 经 手动 更 新 了 数据 库 ， 此 时 可 以 使 用 fake 参数 。 


python manage.py migrate blog --fake 


--database DATABASE 


将 模型 更 改 应 用 到 指定 的 数据 库 ， 默 认 情 况 会 更 新 到 settings.py 


TH 


的 default 数据 库 。 


第 15 章 Django 知识 体系 197 Im 


15.5.3 sglmigrate 


作用 : 输出 某 一 个 migrate 对 应 的 SQL 语句 。 
语法 : django-admin sqlmigrate app label migration name 


示例 : 打印 出 初始 化 的 SQL 脚本 ， 如 图 15-10 所 示 


图 15-10 


15.5.4 showmigrations 


作用 : 显示 migrations 记录 


X: django-admin showmigrations [app label [app_label ...]] 

可 以 通过 --list 或 者 --plan 参数 设置 显示 格式 。--list 按照 应 用 程序 显示 migration 记录 ， 

该 参数 缩写 为 -1，--plan 显示 所 有 记录 ， 缩 写 为 -p。 如 果 某 一 次 migration 已 经 被 部 署 到 数据 
库 中 了 ， 在 该 记录 前 就 会 显示 [X]， 否 则 显示 []， 如 图 15-11 所 示 


第 16 章 
配置 


在 搭建 Django 应 用 程序 的 时 候 需要 进行 一 定 的 配置 ， 除 了 前 面 使 用 过 的 数据 库 配 
置 、 系 统 语言 配置 外 ，Diango 还 提供 了 更 多 的 配置 项 ， 这 些 配置 信息 都 存放 在 配置 文件 
"P, Django 的 配置 文件 是 一 个 Python 模块 ， 所 有 配置 项 都 是 模块 级 别 的 变量 。 本 章 将 会 对 
Django 配置 进行 详细 介绍 。 


EXI Django 配置 文件 


由 于 Django 的 配置 文件 是 一 个 Python 模块 ， 所 以 必须 遵循 以 下 原则 : 
口 不 能 够 出 现 Python 语法 错误 。 
Q 可 以 使 用 Python 语法 动态 指定 配置 值 ， 如 : 


口 可 以 从 其 他 配置 文件 中 引入 变量 。 
使 用 Django 时 必须 通过 环境 变量 DJANGO_SETTINGS_MODULE 指定 当前 工程 所 使 用 
的 配置 文件 ， 默 认 情 况 下 ， 在 manage.py 中 指定 配置 文件 ， 如 : 
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如 果 使 用 WSGI 81-2 Django 应 用 程序 ， 需 要 在 wsgi.py 中 指定 配置 文件 ， 如 : 


import os 

from django.core.wsgi import get wsgi application 
os.environ.setdefault("DJANGO SETTINGS MODULE", "mysite.settings") 
application = get wsgi application() 


如 果 配 置 文件 中 缺少 对 某 个 配置 的 设置 ， 则 会 使 用 Django 的 默认 值 ， 每 一 个 配置 项 在 
Django 的 默认 配置 文件 中 都 已 经 给 出 了 默认 值 。 Django 的 默认 配置 文件 路 径 是 django/conf/ 
global_settings.py， 例 如 Pyghon 安装 在 D 盘 ， 则 默认 配置 文件 的 路 径 就 是 D:\Program FilesV 
Python36\Lib\site-packages\django\conf\global settings.py» 

Django 按照 下 面 算法 编译 配置 文件 : 

C1) 加 载 global settings.py; 

(2) 加 载 工程 指定 的 配置 文件 ， 使 用 工程 指定 的 配置 重 写 默 认 值 。 


引用 Django 配置 信息 


在 Django 应 用 程序 中 可 以 通过 导入 django.conf settings 来 引用 Django 配置 信息 ， 例 如 : 


from django.conf import settings 
if settings.DEBUG: 
pass 


O django.conf.settings 是 一 个 Python 对 象 ， 不 是 模块 ， 所 以 不 能 使 用 下 面 方法 单独 导 
入 配置 信息 : 
from django.conf.settings import DEBUG 


O 由 于 配置 文件 是 在 Django 编译 时 加 载 的 ， 所 以 不 能 在 运行 时 对 系统 配置 进行 修改 。 


Django 核心 配置 


16.3.1 数据 库 


1. DATABASES 
DATABASES 用 于 指定 网 站 所 使 用 的 数据 库 类 型 以 及 连接 方式 ， 它 是 一 个 舱 套 的 字典 对 
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象 ， 字典 的 Key 是 数据 库 别 名 ， 字 典 的 值 是 数据 库 配 置信 息 。 

DATABASES 必须 包含 一 个 别名 为 default 的 数据 库 配置 ，Django 支持 包括 PostgreSQL 、 
MySQL, SQLite, Oracle 等 几 种 主流 数据 库 。 默 认为 一 个 空 字典 ， 此 时 会 使 用 SQLite 数据 库 ， 
该 数据 库 在 创建 Django 应 用 的 时 候 被 自动 创建 。 这 就 是 为 什么 在 第 一 次 搭建 Django 网 站 的 
时 候 ， 什 么 都 没有 做 ， 就 可 以 添加 管理 员 并 且 使 用 后 台 管 理 系统 的 原因 ， 因 为 所 有 信息 都 存 
在 这 个 sqlite 数据 库 中 。 

默认 配置 等 价 于 : 


如 果 需 要 链接 到 其 他 数据 库 ， 就 需要 给 出 更 多 的 配置 信息 。 下 面 是 一 个 用 于 链接 
MySQL 数据 库 的 配置 信息 : 


从 上 面 的 配置 信息 可 以 知道 ，Django 与 其 他 语言 链接 数据 库 的 方式 相似 ， 同 样 需要 链接 
数据 库 的 用 户 名 、 密 码 ， 同 时 需要 给 出 数据 库 所 在 的 主机 名 、 端 口号 以 及 数据 库 名 。 

下 面 介绍 具体 参数 。 

ENGINE: 数据 库 链接 引擎 ， 针 对 不 同 的 数据 库 ，Django 分 别提 供 了 响应 的 引擎 

DD 'django.db.backends.postgresql' 


口 'django.db.backends.mysql' 

口 'django.db.backends.sqlite3' 

口 'django.db.backends.oracle' 

NAME : 数据 库 名 ， 对 于 Sqlite 数据 库 ， 需 要 给 定 Sqlite 文件 路 径 ， 不 论 是 Windows 
系统 还 是 Linux 系统 ， 这 个 文件 路 径 中 一 律 使 用 反 斜 枉 “/”， 例 如 : C:/homes/user/mysite/ 
sglite3.db. 
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USER: 链接 数据 库 的 用 户 名 。Sqlite 不 需要 指定 。 

PASSWORD: 链接 数据 库 的 用 户 密码 。Sqlite 不 需要 指定 。 

HOST: 数据 库 所 在 主机 名 ， 如 果 值 为 空 表 示 本 机 。Sqlite 不 需要 指定 。 

PORT: 为 数据 库 开 放 的 端口 号 ， 如 果 值 为 空 表 示 默 认 端 口 。Sqlite 不 需要 指定 。 


2. DATABASE ROUTERS 

数据 库 路 由 配置 ， 当 执行 数据 库 操作 时 ，Django 会 根据 路 由 配置 选择 恰当 的 数据 库 执行 

操作 。 默 认 值 是 一 个 空 列表 : []， 列 表 元 素 是 一 个 实现 了 特殊 路 由 方法 的 Python 类 的 路 径 。 

要 想 使 用 数据 库 路 由 ， 首 先 需 要 创建 数据 库 路 由 类 ， 该 类 必须 实现 以 下 方法 : 

O db for read(model, **hints): 指定 对 model 进行 读 操作 的 数据 库 。 

O db for write(model, **hints): 指定 对 model 进行 写 操作 的 数据 库 。 

口 allow_relation(obj1, obj2, **hints) : 如 果 人 允许 objl 和 obj2 之 间 存在 关联 则 返回 True, 
如 果 禁 止 objl 和 obj2 之 间 存 在 关联 则 返回 False， 如 果 对 objl 和 obj2 之 间 没 有 限制 
则 返回 None。 

这 个 方法 仅 用 于 验证 两 个 对 象 间 是 否 可 以 存在 外 键 关联 或 者 多 对 多 关联 。 

口 allow_migrate(db, app label, model name-None, **hints) : 该 方法 用 于 确定 数据 库 是 
否 可 以 进行 migration 操作 ， 第 一 个 参数 db 是 数据 库 的 别名 。 方 法 返回 True WK 
IR ILF HEIT migration 操作 ， 返 回 False 则 表示 不 允许 进行 migration 操作 ， 返 回 
None 表示 没有 特殊 规定 。 

参数 app_label 是 进行 migration 操作 的 应 用 程序 名 。 

下 面 举 一 个 数据 库 路 由 的 例子 ， 假 设 存在 如 下 数据 库 配 置 。 
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下 面 创建 一 个 用 于 处 理 auth 应 用 向 auth. db 数据 库 发 送 请 求 的 路 由 类 : 
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接 下 来 创建 一 个 路 由 用 于 处 理 其 他 所 有 应 用 向 数据 库 集群 发 送 的 请 求 ， 对 于 读 操 作 则 在 
集群 中 随机 选择 一 个 数据 库 : 


接 下 来 设置 路 由 信息 : 


注意 ， 所 有 数据 库 操作 都 会 按照 路 由 在 DATABASE. ROUTERS 中 出 现 的 顺序 进行 匹配 ， 
在 本 例 中 会 先 使 用 AuthRouter 执行 数据 库 操作 。 

此 时 任何 auth 应 用 中 的 数据 库 操作 都 将 采用 路 由 AuthRouter， 其 他 应 用 中 的 数据 库 操作 
都 将 采用 路 由 PrimaryReplicaRouter。 

除了 使 用 DATABASE ROUTERS 外 ， 还 可 以 通过 手动 指定 数据 库 的 方式 执行 数据 库 操 
作 ， 例 如 : 

O Question.objects.using('default").all() 

O Question.save(using-' default") 
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16.3.2 文件 上 传 


1. DEFAULT_FILE_STORAGE 
在 没有 特殊 指定 文件 系统 时 ， 指 任何 文件 操作 所 使 用 的 文件 系统 。 默 认 值 是 django.core. 


fles.storage.FileSystemStorage。 


2. FILE CHARSET 
从 磁盘 读 取 文 件 时 所 使 用 的 编码 格式 ， 默 认 值 是 “utf8”。 包 括 读 取 模 板 文 件 以 及 数据 
库 文 件 的 方式 。 


3. FILE UPLOAD HANDLERS 
文件 上 传 处 理 程序 。 
默认 值 : 
[ 
'django.core.files.uploadhandler.MemoryFileUploadHandler', 


'django.core.files.uploadhandler.TemporaryFileUploadHandler', 
1 


4. FILE UPLOAD MAX. MEMORY. SIZE 
允许 上 传 的 文件 的 最 大 体积 ， 单 位 为 字 节 (B), UAH 2621440BQ.5 MB). 


5. FILE UPLOAD PERMISSIONS 

为 上 传 的 文件 设置 权限 ， 默 认 值 为 None， 可 选 值 是 Linux 文件 权限 的 数值 模式 ， 如 
00777 表示 路 径 所 有 者 、 所 在 组 成 员 、 其 他 组 成 员 对 路 径 有 读 、 写 、 执 行 权 限 。 在 大 多 数 操 
作 系 统 中 ， 默 认 的 文件 权限 是 00600。 

6. FILE UPLOAD. DIRECTORY PERMISSIONS 

为 上 传 文件 过 程 中 所 创建 的 文件 夹 设置 权限 ， 默 认 值 为 None， 可 选 值 是 Linux 文件 权 
限 的 数值 模式 ， 如 0o777 表示 路 径 所 有 者 、 所 在 组 成 员 、 其 他 组 成 员 对 路 径 有 读 、 写 、 执 行 
权限 。 

7. FILE_UPLOAD_TEMP_DIR 

文件 上 传 时 ,文件 的 临时 存放 路 径 。 默 认 值 为 None， 此 时 Django 会 使 用 操作 系统 的 默 
认 临 时 路 径 。 

8. MEDIA_ROOT 

用 于 保存 上 传 文件 的 绝对 路 径 ， 如 “ /varwww/example.com/media/”， 默 认 值 是 空 字 
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9. MEDIA URL 

用 于 处 理 MEDIA ROOT 中 所 保存 文件 的 URL， 如 果 MEDIA URL 的 值 不 为 空 ， 的 话 
则 必须 以 斜 本 “1/” 结 尾 ， 例 如 “http://media.example.com/”。 

在 使 用 MEDIA_ROOT 之 前 需要 进行 以 下 配置 : 


如 果 和 希望 在 模板 中 使 用 {{MEDIA URL }}, W 35 3E 34 django.template.context - 
processors.media 添加 到 TEMPLATES 配置 中 ， 如 : 


16.3.8 ”调试 


1. DEBUG 
DEBUG 配置 用 于 指定 当前 网 站 是 否 在 调试 模式 执行 ， 默 认 值 为 False。 如 果 网 站 已 经 部 
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署 在 生产 环境 ,那么 一 定 不 能 开启 DEBUG, 

当 开 启 DEBUG 模式 后 ， 如 果 网 站 运行 过 程 中 出 现 异 常情 况 ， 那 么 异常 信息 会 被 输出 到 
网 页 上 ， 这 些 信息 包括 Django 执行 过 程 、 环 境 信息 settings.py 中 的 配置 信息 。 当 然 出 于 安 
全 考虑 ，Django 不 会 输出 settings.py 中 的 敏感 内 容 ， 例 如 密码 等 ，Django 会 根据 以 下 文字 对 
settings.py 中 的 信息 进行 过 滤 。 

口 API 

OQ KEY 

口 PASS 

口 SECRET 

ü SIGNATURE 

Q TOKEN 

注意 Django 是 按照 模糊 配置 的 方式 在 settings.py 中 对 以 上 文字 进行 匹配 的 ， 例 如 
PASSWORD 会 与 PASS 匹配 成 功 。 虽 然 如 此 ， 在 输出 信息 中 仍然 会 包含 一 些 敏感 信息 。 

最 后 需要 注意 的 是 ， 当 DEBUG 被 设置 为 False 时 ，Django 会 认为 当前 程序 已 经 被 部 
署 到 了 生产 环境 ， 因 此 还 需要 提供 可 以 访问 网 站 的 主机 信息 ， 以 及 相关 配置 在 ALLOWED_ 
HOSTS 中 的 设置 。 

图 16-1 是 DEBUG=True 时 输入 的 部 分 错误 信息 


DATABASES { default’: [ATOMIC REQUESTS' : False, 
* AUTOCONNIT’ : True, 
^ CONN MAX, AGE' : 0, 
ENGINE : ' django. db. backends. mysql’, 


“TEST pemasar None, 
* COLLATION : None, 
MIRROR’ : None, 
“NANE' : None}, 
^TIME ZONE' : None, 
^WSER : 'root']] 
DATABASE, RÜUTERS ü 


图 16-1 


2. DEBUG_PROPAGATE_EXCEPTIONS 

如 果 该 参数 被 设置 为 True， 那 么 当 Django 的 视图 方法 出 现 异常 或 者 需要 返回 HTTP 500 
响应 时 ， 异 常 信息 将 会 被 Web 服务 器 接收 并 处 理 而 不 是 由 Django 来 处 理 。 

该 参数 的 默认 值 是 False。 如 果 和 希望 看 到 详细 异常 信息 则 不 应 该 将 它 设置 为 True。 

图 16-2 是 DEBUG PROPAGATE EXCEPTIONS 为 True 时 网 页 出 现 异常 时 的 情况 。 
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A server error occurred. Please contact the sdministrator. 


图 16-2 
16.3.4 HTTP 


1. DATA, UPLOAD. MAX, MEMORY. SIZE 

表示 一 次 HTTP 请 求 的 最 大 值 ， 单 位 为 字 节 。 默 认 值 是 2621440B (2.5 MB ) 。 当 访问 
request.body 或 者 request.POST 的 时 候 进行 检查 ， 检 查 内 容 不 包括 正在 上 传 的 文件 体积 。 可 
以 通过 将 DATA_UPLOAD_ MAX MEMORY SIZE 设置 为 None 的 方式 来 禁用 HTTP 请 求 体 
积 的 检查 。 

HTTP 请 求 的 大 小 与 处 理 程序 所 占用 的 内 存 相关 ，HTTP 请 求 越 大 处 理 程序 所 使 用 的 内 
存 就 越 多 。 如 果 没有 对 HTTP 请 求 大 小 进行 限制 将 会 被 服务 器 攻击 程序 所 利用 ， 攻 击 程序 利 
用 不 停 发 送 特大 请 求 包 的 方式 攻击 服务 器 ， 导 致 服务 器 内 存 被 巨 速 耗 尽 ， 最 终 服 务 器 瘫痪 。 

2. DATA UPLOAD MAX NUMBER FIELDS 

一 次 HTTP 请 求 所 能 接收 的 最 大 参数 数量 ， 包 括 GET 请 求 和 POST 请 求 ， 默 认 值 是 
1000。 可 以 通过 将 DATA UPLOAD MAX NUMBER FIELDS 设置 为 None 的 方式 来 禁用 该 
检查 。 

由 于 GET 和 了 POST 请 求 是 一 个 字典 ， 所 以 参数 数量 会 影响 请 求 的 执行 时 间 。 如 果 没 有 
对 HTTP 请 求 的 参数 数量 进行 限制 的 话 ， 会 被 攻击 程序 所 利用 ， 攻 击 程序 通过 提交 包含 很 多 
参数 的 请 求 来 占用 服务 器 处 理 时 间 ， 最 终 导致 服务 器 瘫痪 。 

3. DEFAULT_CHARSET 

如 果 在 HTML 代 码 中 没有 使 用 MIME 指 定 字 符 集 ，DEFAULT CHARSET 表 示 
HttpResponse 对 象 所 使 用 的 字符 集 ， 默 认 值 为 “ utf-8”。 与 配置 信息 DEFAULT_CONTENT_ 
TYPE 共同 决定 了 HTML header 中 的 Content-Type. 


4. DEFAULT. CONTENT TYPE 
如 果 在 HTML 代码 中 没有 使 用 MIME 指定 文档 内 容 类 型 ， DEFAULT CONTENT - 
TYPE 表示 HttpResponse 对 象 所 使 用 的 文档 内 容 类 型 ， 默 认 值 为 “texthtml”。 与 配置 信息 
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DEFAULT CHARSET 共同 决定 了 HTML header 中 的 Content-Type. 


| HOT HIML 5 中 不 再 需要 在 header 中 指定 content 了 ， 以 及 这 个 属性 与 某 些 第 三 方 应 
| 用 不 兼容 ， 所 以 在 Django 2.0 中 不 建议 使 用 该 配置 。 


1 
1 
1 
1 
1 
1 


5. WSGI APPLICATION 

指向 WSGI 应 用 的 Python 路径 ， Django 的 内 置 服务 器 将 会 使 用 这 个 应 用 程序 运行 
Django 代码 。 

在 使 用 django-admin startproject 命令 创建 Django 工程 的 时 候 会 自动 创建 一 个 wsgi.py 
脚本 ， 在 这 个 脚本 中 存在 一 个 可 执行 的 application 对 象 ，WSGI APPLICATION 就 是 这 个 
application 对 象 的 路 径 。 


16.3.5 国际 化 


1. 日 期 时 间 格 式 设置 

Django 中 有 多 个 日 期 时 间 格 式 设置 参数 : DATE FORMAT, DATE INPUT FORMATS, 
DATETIME FORMAT, DATETIME INPUT FORMATS, TIME FORMAT, TIME INPUT - 
FORMATS ， 分 别 用 于 设置 日 期 的 显示 格式 、 在 文本 框 中 日 期 的 输入 格式 、 日 期 时 间 的 显示 
格式 、 在 文本 框 中 日 期 时 间 的 输入 格式 、 时 间 的 显示 格式 、 在 文本 框 中 时 间 的 输入 格式 。 

DATE FORMAT 的 默认 值 是 'Nj, Y'"， 显 示 效果 : Feb. 4, 2003。 

DATE INPUT FORMATS 的 默认 值 是 : 


DATETIME FORMAT 的 默认 值 是 "Nj, Y, P'"， 显 示 效 果 : Feb. 4, 2003, 4 p.m.。 
DATETIME INPUT FORMATS 的 默认 值 是 : 
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'$y-$m-$d $H:$M', # '2006-10-25 14:30" 
'$y-$m-$d', 3 '2006-10-25"' 

'S$m/*$d/$Y $H:$M:$S', # '10/25/2006 14:30:59" 
'S$m/S$d/$Y $H:$M:$S.9f', # '10/25/2006 14:30:59.000200" 
'$m/*$d/$Y $H:$M', # '10/25/2006 14:30" 
'$m/$d/$Y', * '10/25/2006" 

'$m/*$d/$y $H:$M:$S', # '10/25/06 14:30:59" 
'$m/$d/$y $H:$M:$S.*f', 4 '10/25/06 14:30:59.000200"* 
'$m/$d/*$y $H:3M', * '10/25/06 14:30" 

'$m/sd/sy', * '10/25/06' 


] 
TIME FORMAT 的 默认 值 是 'P'， 显 示 效 果 : (e.g. 4 p.m.)。 
TIME INPUT FORMATS 的 默认 值 是 : 


[ 


'$H:$M:$S', # '14:30:59" 
'S$H:$M:$S.9f', 4 '14:30:59.000200" 
'$H:$M', # '14:30' 


] 


可 选 的 日 期 时 间 格 式 化 字符 串 如 表 16-1 所 示 
表 16-1 


例 


3l 


ISO 8601 格式 日 期 字符 串 
注意 ,与 “Z”“0” 或者“r” 等 格式 化 字符 不 同 的 是 ，| 2008-01-02T10:30:00.000123+02:00 或 
理 本 地 时 间 时 ,“c” 格 式 化 字符 不 会 为 时 间 添 加 | 2008-01-02T10:30:00.000123 (本 地 时 间 ) 


偏 移 量 ) 

两 位 数字 表示 每 月 的 第 几 天 ， 当 数字 小 于 10 时 , | us 
《| 用 数字 0 在 左 侧 补 齐 两 位 m 
D 用 三 个 字母 的 缩 略 形式 表示 每 周 的 第 几 天 "Fri! 


时 区 。 具 体 返 回 值 取决 于 datetime 对 象 ， 可 以 返回 任 
意 格式 ， 也 可 以 返回 空 字符 串 


E 月 份 , 本 地 化 表现 形式 ， 多 用 于 长 日 期 类 型 "istopada'( 波兰 语 ) 
时 间 ，12 小 时 制 格 式 
(注意 ， 当 分 钟 数 为 零 时 则 不 显示 ) 


F 长 文本 格式 的 月 份 "January' 


". 'GMT', '-500', "US/Eastern' 等 


"gs 11:30! 
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ad 
格式 化 字符 描 x m A 
g 12 小 时 制 小 时 ， 没 有 前 导数 字 0 T1? 
G 24 小 时 制 小 时 ， 没 有 前 导数 字 0 至 23' 
h 12 小 时 制 小 时 ， 有 前 导数 字 0 or 3 12 
H 24 小 时 制 小 时 ， 有 前 导数 字 0 '00' 至 '23' 
i 分 钟 ， 有 前 导数 字 0 '00' Æ '59' 
I 夏令 时 了 至 0 
j 每 月 中 的 第 几 天 ， 无 前 导数 字 0 TÆ 
1 长 文本 格式 的 星期 "Friday 
L 是 否 是 闽 年 True 或 者 False 
m 月 份 ， 使 用 两 位 数字 表示 ， 有 前 导数 字 0 or $2 
M 月 份 ， 使 用 三 个 字母 的 缩 略 形式 表示 Van' 
n 月 份 ， 数 值 形式 ， 无 前 导数 字 0 "t2 
N 美 联 社 风格 的 月 份 缩 写 词 'Jan.', 'Feb.', 'March', 'May' 
o ISO-8601 星期 编号 年 '1999' 
o 与 格林 威 治 时 间 的 时 间 差 (以 小 时 计 ) '+0200' 
12 小 时 制 的 小 时 分 钟 及 'am.Vp.m"， 分 钟 数 若 为 零 则 m 
p 不 显示 。 用 字符 串 表 示 特 殊 的 时 间 点 ， 如 midnight | 1 130P midnight, "noon, 
和 moon' Prae 
r RFC 5322 格式 的 日 期 'Thu.21Dec200016:01:07+0200' 
S 秒 ， 两 位 数字 形式 ， 有 前 导数 字 0 '00' Æ '59' 
S 英语 序数 后 级 ， 用 于 表示 一 个 月 的 第 几 天 ， 两 个 字符 'st', "nd', "rd ER 'th' 
t 给 定 月 份 的 总 天 数 28 至 31 
T 本 机 时 区 'EST', 'MDT' 
u 毫秒 000000 至 999999 
u 以 秒 为 单位 计算 的 距离 新 纪元 开始 的 时 间 (新 纪元 时 
间 为 January 1 1970 00:00:00 UTC) 
w 星期 ， 数 值 形式 ， 没 有 前 导数 字 0 "0( 星 期 日 ) 至 "6( 星 期 六 ) 
" ISO-8601 一 年 的 第 多 少 星 期 数 ， 此 时 每 周 的 起 始 日 期 
是 星期 一 
y 两 位 数字 表示 的 年 '99' 
Y 四 位 数字 表示 的 年 '1999' 
z 日 期 在 一 年 中 的 排序 0 到 365 
元 以 秒 计 的 时 区 偏 移 量 。 这 个 偏 移 量 对 UTC 西部 时 区 总 43300 38 43200 


是 负数 ， 而 对 UTC 东部 时 区 则 总 是 正 数 
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2. TIME_ZONE 

当前 程序 所 在 的 时 区 ， 默 认 值 为 'America/Chicago'。 中 国 所 在 时 区 为 Asia/Shanghai， 如 
果 将 时 区 设置 为 Asia/Chongqing、Asia/Harbin 等 中 国 时 区 ， 其 本 质 就 是 Asia/Shanghai。 

所 有 可 选 时 区 可 以 在 维基 百科 中 查 到 : 


https://en.wikipedia.org/wiki/List of tz database time zones 


3. LANGUAGE CODE 

当前 程序 所 使 用 的 语言 ， 默 认 值 为 'en-us'。 简 体 中 文 为 'zh-Hans'。 

所 有 可 选 语言 编码 可 以 在 il8nguy 上 查看 : http://www.il8nguy.com/unicode/language- 
identifiers.html 
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4. USE I18N 
规定 Django 是 否 启 用 翻译 系统 ， 设 置 为 True 的 话 ，Dijango 会 将 系统 语言 翻译 成 
LANGUAGE CODE 所 指定 的 语言 ， 这 会 带 来 一 定 的 性 能 损耗 。 默 认 值 为 False。 


5. USE L10N 
规定 Django 是 否 启用 格式 化 系统 ， 设 置 为 True 的 话 ，Django 会 对 数字 、 日 期 、 时 间 字 
符 串 进行 格式 化 。 默 认 值 为 False。 


6. USE TZ 

规定 Django 是 否 使 用 UTC 时 间 ， 如 果 设 置 为 False 则 使 用 本 地 时 间 。 如 果 将 USE TZ 
设置 为 True 后 ， 所 有 系统 中 的 时 间 都 将 被 自动 转换 为 UTC 时 间 ， 避 免 了 时 间 冲 突 。 

例如 当 USE_TZ 设置 为 True 时 ， 在 Admin 后 台 管 理 系统 保存 一 条 调查 问卷 ， 检 查 数据 
库 中 保存 的 时 间 以 及 网 页 中 显示 的 时 间 。 

数据 库 中 显示 的 是 UTC 时间， 如 图 16-3 所 示 。 


Tabie: [器 pols question. 
id question text. pub date 
Filter Filter [Fiter 
ipo . |fBiiDjengol? 2017-12-07 12:12:00 
图 16-3 
网 页 中 显示 的 是 本 地 时 间 ， 如 图 16-4 所 示 。 
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ap [———— vA] rror 
目 QUESTIONTEXT DATE PUBLISHED. WAS PUBLISHED RECENTLY 
目 你 喜欢 Django 四? 2017 年 12 有 7 日 20-12 True 
1 question. 
图 16-4 
16.3.6 日 志 
1. LOGGING 


表示 日 志 配 置信 息 ，LOGGING 的 内 容 将 会 被 当 作 参数 传递 给 LOGGING_CONFIG。 默 
认 配 置信 息 存储 在 django/utils/log.py Fo 

2. LOGGING_CONFIG 

该 参数 指向 一 个 用 于 配置 日 志 系统 的 可 调用 对 象 的 路 径 。 默 认 使 用 Python 的 
dictConfig: logging.config.dictConfg。 

如 果 将 LOGGING_CONFIG 设置 为 None， 系 统 将 禁用 日 志 功能 。 


16.3.7. ”模板 


TEMPLATES 是 一 个 包含 所 有 模板 引擎 配置 信息 的 数组 ， 数 组 中 的 每 一 个 成 员 都 是 一 个 
包含 模板 引擎 配置 信息 的 字典 。 

下 面 是 一 个 最 简单 的 模板 配置 ， 通 过 这 个 配置 ， 模 板 引擎 (BACKEND ) 将 会 在 所 有 已 
安装 的 应 用 程序 子 目录 中 查找 templates 文件 夹 ， 并 在 该 文件 夹 中 加 载 模 板 : 


下 面 是 Pols 应 用 的 模板 配置 ; 
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'django.template.context processors.debug', 
'django.template.context processors.request', 
'django.contrib.auth.context processors.auth', 
'django.contrib.messages.context processors.messages', 


1 

BACKEND: 模板 引擎 的 Python P1, Django 内 置 的 模板 引擎 包括 以 下 两 个 : 

O 'django.template.backends.django.DjangoTemplates' 

O 'django.template.backends.jinja2.Jinja2' 

DIRS: 列表 对 象 ， 每 个 列表 成 员 都 是 一 个 模板 文件 的 存放 路 径 。 模 板 文件 的 路 径 在 列表 
中 的 位 置 就 是 模板 引擎 查找 模板 文件 的 顺序 。 

APP DIRS: 规定 模板 引擎 是 否 在 已 安装 的 应 用 程序 中 查找 模板 文件 ， 默 认为 True。 

OPTIONS : 额外 传递 给 模板 引擎 的 参数 ， 不 同 的 模板 引擎 包含 不 同 的 参数 ， 如 
DjangoTemplates X; f$ autoescape, context processors, file charset 等 参 数 ; Jinja2 支 ff 
context processors. 

除了 以 上 配置 信息 外 ，Django 的 模板 配置 还 支持 国际 化 配置 等 ， 如 TIME FORMAT, 
TIME ZONE 等 ， 这 与 前 面 介绍 的 国际 化 配置 一 致 ， 在 此 不 再 袭 述 。 


16.338 安全 


1， 跨 站 点 请 求 伪造 保护 
通常 黑客 可 以 在 其 他 网 站 中 制造 虚假 链接 诱 使 用 户 单 击 该 链接 向 目标 网 站 发 送 请 求 ， 如 
果 此 时 用 户 正 在 登录 目标 网 站 或 者 用 户 session 还 没 过 期 ， 那 么 目标 网 站 就 会 接收 并 执行 
请 求 。 为 了 避免 服务 器 程序 执行 这 些 虚 假 链 接 ，Django 提供 了 CSRF (Cross Site Request 
Forgery， 跨 站 点 请 求 伪 造 ) 验证 ， 以 下 是 部 分 CSRF 设置 。 
Q CSRF COOKIE AGE : CSRF cookie 的 有 效 期 ， 默 认为 31449600 (接近 一 年 )， 超 长 
的 有 效 期 可 以 保证 CSRF 一 直 保 护 用 户 。 
Q CSRF COOKIE DOMAIN : CSRF 允许 的 主机 名 。 上 面 例子 中 黑客 所 制作 的 虚假 链 
接 就 是 寄宿 在 其 他 网 站 ， 所 以 当 CSRF 主机 名 不 同时 ， 网 站 将 拒绝 执行 。 默 认 值 为 
None。 
Q CSRF COOKIE NAME: CSRF 身份 认证 所 使 用 的 cookie 名 ， 默 认为 csrftoken 。 
O CSRF COOKIE PATH : CSRF cookie 的 存储 路 径 ， 默 认为 “\" 。 当 同一 主机 上 运行 
多 个 Django 程序 时 ， 有 必要 将 不 同 网 站 的 cookie 分 开 存储 。 
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Q CSRF COOKIE SECURE: 是 否 使 用 HTTPS 的 方式 发 送 CSRF cookie. SA JJ False. 
当 设置 为 True 时， 浏览 器 将 以 HTTPS 的 方式 发 送 CSRF cookies 

Q CSRF USE SESSIONS : 规定 是 否 将 CSRF token 保存 在 用 户 session 中 而 不 是 保存 在 
cookie 中 。 默 认为 False。 在 Django 中 ， 两 种 保存 方式 都 是 安全 的 ， 开 发 人 员 可 以 根 
据 个 人 喜好 进行 设置 。 

O CSRF FAILURE VIEW: 当 用 户 请 求 因为 CSRF 原因 被 拒绝 时 ， 处 理 该 请 求 的 视图 路 
径 。 默 认 值 为 'django.views.csrf.csrf failure'. 视图 签名 如 下 : 


def csrf failure(request, reason-""): 


Q CSRF HEADER NAME : 用 户 CSRF 身份 认证 的 HTTP 请 求 头 。 默 认 名 为 HITP X 
CSRFTOKEN. 

O CSRF TRUSTED ORIGINS : 不 安全 请 求 的 授信 列表 。 对 于 不 安全 请 求 (例如 POST 
请 求 )，Django 要 求 HTTP 请 求 的 主机 名 要 与 上 一 个 请 求 一 致 。 但 是 当 两 个 请 求 来 
自 于 同一 网 站 的 不 同 子 域名 时 ，Django 也 会 阻止 该 请 求 ， 例 如 来 自 于 subdomain. 
example.com 的 POST 请 求 紧 跟 在 api.example.com 之 后 也 会 被 阻止 ， 这 其 实 是 不 合 
理 的 。 为 了 解决 这 个 问题 ， 可 以 将 subdomain.example.com 添加 到 CSRF TRUSTED - 
ORIGINS 列表 中 。CSRF_ TRUSTED ORIGINS 列表 也 可 以 接收 子 域名 ， 如 example. 
com 表示 网 站 信任 所 有 来 自 example.com 的 请 求 。 


2. SECRET KEY 
表示 Django 工程 的 密 钥 ， 该 密 钥 将 会 用 于 加 密 签 名 ， 它 的 值 是 一 个 随机 字符 串 ， 每 个 
工程 都 不 一 样 。 
在 使 用 django-admin 创建 工程 时 会 自动 为 工程 创建 一 个 秘 钥 。 


16.3.9 URL 


1. ROOT_URLCONF 

URL 配置 的 根 位 置 ， 如 前 面 示例 中 的 ROOT_URLCONF = 'mysite.urls'。Django 处 理 用 
户 请 求 时 会 先 查找 ROOT_URLCONF 中 的 URL 配置 ,在 ROOT_URLCONF 中 可 以 包含 其 他 
URL 配置 信息 。 


2. APPEND_SLASH 
当 APPEND_SLASH 设置 为 True 时 ， 如 果 用 户 访问 的 URL 不 是 以 1/ 结尾， 并 且 路 由 系 


$162 配置 215 |E 


统 没 有 在 URLconf 中 找到 匹配 的 URL 时 ， 系 统 会 自动 在 用 户 访问 的 URL 后 面 添加 一 个 /， 
然后 进行 重 定 向 。 注 意 此 时 的 URL 重 定向 可 能 会 导致 POST 请 求 中 所 提交 的 数据 丢失 。 
要 想 使 APPEND SLASH 生效 ， 必 须 确保 已 经 安装 了 CommonMiddleware。 


3. PREPEND WWW 
优先 使 用 WWW 作为 URL R 
要 想 使 PREPEND_ WWW 生效 ， 必 须 确保 已 经 安装 了 CommonMiddleware。 
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简洁 优雅 的 URL 结构 是 高 质量 Web 应 用 程序 的 象征 。Django 允许 开发 人 员 设 计 任何 形 
式 的 URL， 这 在 早期 的 网 站 中 是 不 可 想象 的 。 早 期 的 网 站 通常 会 有 很 长 的 一 串 URL, mH. 
通常 URL 还 会 包括 一 些 无 用 信息 ， 如 aspx, php 等 。 

为 了 给 应 用 程序 设计 URL， 开 发 人 员 需 要 开发 一 个 Python 模块 ， 这 个 模块 就 是 URL 的 
配置 信息 ， 通 常 我 们 将 这 个 配置 模块 叫 作 URLconf。 这 个 模块 是 一 个 纯粹 的 Python 脚本 ， 它 
包含 了 URL 表达 式 与 Python 方法 之 间 的 映射 ， 这 里 的 Python 方法 就 是 Django 应 用 中 的 视 
图 方法 。 前 面 示例 中 的 mysite/urls.py 和 polls/urls.py 就 是 两 个 URLconf 实例 。 


ERE Django 处 理 HTTP 请 求 的 流程 


当 用 户 发 起 一 个 HTTP 请 求 时 ，Django 就 会 按照 以 下 逻辑 对 请 求 进行 处 理 : 

(1) 确定 URL 根 配 置 位 置 ， 通 常 URL 根 配置 在 ROOT_URLCONF 中 设置 。 

(2) 加 载 配置 信息 ， 在 配置 信息 中 查找 urlpatterns。 

(3) 按 顺序 检索 urlpatterns 中 的 所 有 URL 模式 字符 串 ， 并 定位 在 第 一 个 与 URL 匹配 的 
URL 模式 字符 串 。 

(4) 当 检 索 到 匹配 的 URL 模式 字符 串 后 ， 调 用 对 应 的 视图 方法 ， 并 传递 以 下 参数 给 视 
图 方法 : 

口 一 个 HttpRequest 对 象 实例 。 

O 如 果 匹 配 的 URL 模式 字符 串 不 包含 任何 组 ， 那 么 匹配 的 信息 会 作为 位 置 参数 传递 给 


视图 。 
O 如 果 URL 模式 字符 串 中 的 参数 给 定 了 参数 名 ， 那 么 匹配 的 信息 会 作为 命名 参数 传递 


(5) 如 果 在 URLconf 中 没有 找到 任何 匹配 的 URL 模式 字符 串 ， 或 者 出 现 其 他 任何 错 
ÙR, Django 将 会 调用 一 个 用 于 处 理 错误 信息 的 视图 。 
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URLconf 示例 


下 面 是 一 个 URLconf 的 简单 示例 。 


from django.urls import path 
from . import views 


urlpatterns = [ 
path('articles/2003/', views. special case 2003), 
path('articles/«int:year»/', views.year archive), 
path('articles/«int:year»/«int:month»/', views .month archive), 
path('articles/«int:year»/«int:month»/«slug:slug»/', views.article detail), 


1 

示例 解读 : 

O 函数 path 的 第 一 个 参数 是 一 个 URL 模式 字符 串 ， 用 于 匹配 URL, 

O 函数 path 的 第 二 个 参数 是 用 于 处 理 URL 请 求 的 视图 函数 。 

O 使 用 尖 括 号 提取 URL 中 的 参数 ， 如 <int:year> 

O 可 使 用 类 型 转化 器 对 参数 类 型 进行 转换 ， 如 int: 会 将 从 URL 中 捕获 的 值 转换 为 数值 
类 型 ， 如 果 没 有 指定 类 型 转换 器 ， 如 <year>， 则 任何 不 包含 / 的 字符 串 都 会 被 提取 。 

O URL 模式 字符 串 不 需要 以 /开头 。 

应 用 场景 : 

Q 发 送 向 /articles/2005/03/ 的 请 求 将 会 与 第 三 个 URL 模式 字符 串 匹 配 成 功 ， 匹 配 成 功 后 
Django 调用 views.month archive(request, year-2005, month-3). 

Q 发 送 向 /articles/2003/ 的 请 求 将 会 与 第 一 个 URL 模式 字符 串 匹配 成 功 而 不 是 第 二 个 ， 
因为 Django 在 第 一 个 URL 匹配 成 功 后 停止 后 续 URL 检验 ,匹配 成 功 后 Django 调用 
views.special case 2003(request). 

O 发 送 向 /articles/2003 的 请 求 不 会 与 任何 URL 模式 字符 串 匹 配 成 功 ， 因 为 每 个 URL f 
式 字符 串 都 要 求 以 / 结束。 

Q 发 送 向 /articles/2003/03/building-a-django-site/ 的 请 求 将 会 与 最 后 一 个 URL 模式 字符 

串 匹 配 成 功 ， 匹 配 成 功 后 Django 调用 views.article detail(request, year=2003, month-3, 

slug-"building-a-django-site") 


URL 参数 类 型 转化 器 


前 面 提 到 可 以 使 用 int 对 捕捉 到 的 URL 参数 进行 类 型 转换 ， 下 面 是 Django 支持 的 所 有 
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类 型 转换 器 。 

Q st: 匹配 任意 非 空 字符 串 ， 但 是 不 能 匹配 URL 分 隔 符 “/”。 这 是 默认 的 URL 参数 转 
换 器 。 

Q int: 匹配 任意 大 于 等 于 0 的 整数 。 

Q slug: 匹配 任意 slug 字符 串 ,slug 字符 串 可 以 包含 任意 ASCI 字符 、 数 字 、 连 字符 “-” 
MFM CU. 

O wid: 匹配 UUID 字符 串 (字符 串 中 的 字母 必须 为 小 写字 母 )， 例 如 : 07519443-6885- 
417e-a8a8-6c931e272f00.. 

O path : 匹配 任意 非 空 字符 串 ， 包 括 URL 分 隔 符 “/”。 这 允许 匹配 完成 的 URL 而 不 是 
URL 的 一 个 片段 。 


EZ (bx URL 参数 类 型 转化 器 


对 于 更 加 复杂 的 URL 场景 ， 开 发 人 员 可 以 开发 自 定义 参数 类 型 转换 器 ， 自 定义 参数 类 
型 转换 器 包括 以 下 几 部 分 ; 
O 一 个 regex 属性 ， 属 性 值 为 正则 表达 式 。 
O — to python(self, value) 方法 ， 该 方法 用 于 将 匹配 的 URL 参数 转换 为 指定 类 型 ， 当 
类 型 转换 失败 后 抛 出 ValueError 异常 。 
O 一 个 to urlself, value) 方法 ， 该 方法 用 于 将 Python 类 型 转换 为 类 型 转换 器 字符 串 。 
下 面 是 一 个 用 于 捕获 日 期 年 的 类 型 转换 器 : 


使 用 register converter 将 以 上 类 型 转换 器 注册 到 URLconf。 
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创建 视图 : 


此 时 目录 结构 如 下 : 


启动 Web 服务 ,访问 URL， 如 图 17-1 所 示 。 
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使 用 正则 表达 式 


与 Django 1.x 一 样 ，Django 2.0 仍然 可 以 使 用 正则 表达 式 匹 配 URL， 此 时 需要 使 用 re_ 
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path) 方法 而 不 是 path - 

Python 的 正则 表达 式 支持 对 分 组 进行 命名 ,语法 格式 为 :(?P<name>pattern)， 其 中 name 
为 分 组 名 ，pattern 为 匹配 的 正则 表达 式 。 

使 用 正则 表达 式 对 前 面 的 URLconf 进行 重 写 效果 如 下 : 


虽然 可 以 使 用 未 命名 的 正则 表达 式 ， 例 如 使 用 ([0-9]{4}) 替代 (?P<year>[0-9]{4})， 但 是 
为 了 防止 出 现 意外 错误 ,推荐 对 分 组 命名 。 

另外 需要 注意 ， 不 要 将 命名 正则 表达 式 与 未 命名 正则 表达 式 混合 使 用 ， 这 样 会 造成 未 命 
名 正则 表达 式 丢 失 。 

最 后 正则 表达 式 可 以 嵌 套 使 用 ， 如 : 


eammenes/ (2:page- page ubere) E, comments) | 
Ed 导入 其 他 URLecf ooo 


对 于 现代 Web 应 用 程序 来 说 ， 一 个 工程 下 通常 会 包含 多 个 应 用 程序 ， 每 个 应 用 程序 
包含 很 多 URL， 如 果 将 这 些 URL 都 写 在 URLconf 根 模块 中 ,那么 URLconf 将 会 变 得 非常 
腾 肿 ， 不 利于 维护 。 对 于 这 种 情况 ， 常 用 的 解决 办 法 就 是 为 每 一 个 应 用 程序 写 一 套 独立 的 
URLconf， 而 URLconf 根 模块 通过 使 用 include) 方法 将 其 他 URLconf 引用 进来 。 

下 面 是 Polls 网 站 的 mysite/urls.py: 
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当 Django 过 到 include() 方法 时 ，URL 匹 配 工作 跳 转 进入 被 引用 的 URLconf 进行 验证 。 
使 用 include0 方法 还 可 以 引用 其 他 URL 模式 列表 ,例如 : 


此 时 访问 /credit/reports/ 时 将 会 调用 credit_views.report() 视图 方法 。 这 样 做 的 好 处 是 当 
一 个 应 用 程序 中 多 条 URL 的 前 级 相同 时 ， 在 本 例 中 extra patterns 中 的 URL 都 是 以 credit FF 
头 ， 可 以 简化 URL 模式 字符 串 。 


AEA 向 视图 传递 额 外 参数 


可 以 使 用 path0 方法 的 第 三 个 参数 向 视图 传递 额外 参数 ， 例 如 : 


也 可 以 向 include0 方法 传递 额外 参数 ， 例 如 : 
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此 时 ,额外 参数 fblog id': 3) 将 会 被 传递 给 每 一 个 被 引用 的 URL。 


EE 动态 生成 URL 


在 网 页 应 用 中 ， 很 多 情况 下 需要 动态 编写 URL， 而 不 是 用 户 直 接 在 浏览 器 中 输入 URL, 
例如 网 页 超 链 接 的 URL 需要 在 生成 网 页 时 固定 好 。 
用 以 下 URL 模式 字符 串 为 例 ， 看 看 如 何在 Django 模板 和 视图 中 动态 生成 URL: 


1. 使 用 url 标签 在 模板 中 动态 生成 URL 


2. 使 用 reverse() 方 法 在 Python 代码 中 生成 URL 


URL 名字 和 命名 空间 


给 URL 命名 ， 可 以 方便 地 在 模板 或 Python 代码 中 使 用 URL， 如 前 面 示例 中 分 别 在 模板 
和 Python 代码 中 使 用 了 URL 的 名 字 mews-year-archive'。 
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URL 命名 空间 用 于 将 URL 进行 隔离 。 应 用 程序 名 就 可 以 作用 URL 的 命名 空间 ， 例 如 
django.contrib.admin 的 命名 空间 就 是 admins H F Django 的 应 用 程序 可 以 部 署 多 次 ， 所 以 应 
用 程序 的 实例 名 也 可 以 作为 命名 空间 。 

使 用 “命名 空间 名 :URL 名 ”的 方式 调用 URL。 命 名 空间 可 以 向 套 使 用 如 “命名 空间 名 
1: 命名 空间 名 2:URL 名 ”。 


1 定义 命名 空间 
在 URLconf 模块 中 使 用 app. name 属性 声明 命名 空间 ， 例 如 : 


或 者 ， 直 接 在 urlpatterns 中 定义 命名 空间 : 


上 面 polls patterns 是 一 个 元 组 ， 元 组 的 第 一 个 参数 是 path() 或 re_path() 列表 ， 第 二 个 
参数 是 URL 的 namespace。 当 使 用 include0 方法 引用 polls patterns 时 系统 会 自动 为 polls_ 
patterns 中 的 所 有 URL 添加 namespace. 


2. 在 其 他 URLconf 中 使 用 命名 空间 
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3. 在 模板 文件 中 使 用 命名 空间 
(o Qumb'polssndet 8) 0000 
4. 在 Python 代码 中 使 用 命名 空间 
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模型 


A seni 


模型 是 一 个 用 于 表示 数据 的 Python 类 ， 包 含 基本 的 数据 字段 和 行为 ， 在 Django 'P, 38 
常 一 个 模型 就 代表 一 个 数据 库 表 。 模 型 继承 自 django.db.models.:Model， 模 型 的 每 一 个 属性 代 
表 一 个 数据 表 的 列 。 

前 面 已 经 使 用 模型 创建 过 问卷 调查 系统 的 调查 问卷 类 和 选项 类 ， 下 面 用 一 个 简单 的 例子 
介绍 模型 ， 下 面 的 模型 Person 属于 myapp 应 用 : 


模型 Person 包括 两 个 字段 : first name 和 last_name。 这 两 个 字段 都 是 模型 的 类 属性 ， 分 
别 对 应 数据 库 表 中 的 两 个 列 。 

当 执 行 migrate 命令 时 ，Django 会 执行 类 似 下 面 的 SQL 脚本 来 创建 Person 对 应 的 数据 
库 表 : 


脚本 解释 : 

O Django 根据 模型 所 属 应 用 程序 生成 数据 库 表 名 ， 命 名 规则 : 应 用 程序 名 _ 模 型 名 ; 

O Django 自动 添加 id 字段 作为 数据 库 表 的 主键 ， 与 其 他 字段 一 样 可 以 自 定义 主键 ， 自 
定义 主键 需要 包含 “primary_key=True”， 格 式 如 下 : 
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使 用 模型 


模型 创建 完成 后 ， 需 要 在 Django 的 配置 文件 中 注册 模型 。 打 开 settings.py 文件 ， 找 到 
INSTALLED APPS 配置 项 ， 将 模型 所 在 应 用 程序 名 添加 到 列表 中 。 一 般 情 况 下 ， 应 用 程序 
名 就 是 使 用 manage.py startapp 命令 时 所 填写 的 名 字 。 如 果 忘 记 了 应 用 程序 名 ， 可 以 到 应 用 程 
序 文 件 夹 下 找到 apps.py 脚本 文件 ， 打 开 即 可 找到 应 用 程序 名 : 


新 的 配置 信息 如 下 : 


配置 完成 ， 需 要 执行 以 下 migration 命令 生成 对 应 的 数据 库 表 : 


字段 


字段 是 模型 的 最 重要 组 成 部 分 ， 它 是 一 系列 数据 表 列 的 定义 。 模 型 字段 是 模型 的 类 
属性 ， 它 的 命名 不 能 与 模型 接口 相同 ， 如 不 能 定义 名 为 clean save, delete 的 字段 ， 同 
时 字段 名 字 中 不 能 出 现 连续 的 两 个 下 画 线 ， 因 为 连续 两 个 下 画 线 是 Django 数据 库 API 的 
特殊 语法 。 

每 一 个 模型 字段 类 型 都 对 应 一 种 数据 库存 储 格 式 以 及 HTML 元素 。 

为 了 支持 不 同 的 数据 库 ，Django 提供 了 几 十 种 字段 类 型 ， 常 用 的 有 以 下 几 种 。 


1. AutoField 


IntegerField 的 改进 形式 ， 字 段 值 根据 已 有 的 ID 自动 增长 ， 常 用 作 主 键 。 一 般 情况 下 
Django 已 经 帮 你 自动 创建 了 。 
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2. BigAutoField 
5j AutoField 相似 ， 不 过 BigAutoField 使 用 64 位 整 型 存储 数据 ， 取 值 范围 从 1 至 
9223372036854775807。 


3. BooleanField 

字段 值 只 包含 Tue 和 False。 类 似 于 SQL Server 中 的 bit 类 型 。 上 默认 情况 下 ， 
BooleanField 对 应 HTML 的 复 选 框 : <input type="checkbox" ...>。 如 果 没 有 设置 Field.default 
属性 ， 那 么 它 的 默认 值 是 None. 


4. CharField 

字符 串 类 型 ， 用 于 保存 不 太 长 的 字符 串 。 使 用 该 字段 必须 要 给 出 CharField.max length, 
该 属性 指定 了 CharField 所 能 接收 的 最 大 字符 数 ， 也 用 于 字段 有 效 性 验证 。 默 认 情 况 下 ， 
CharField 对 应 HTML 的 文本 框 : <input type="text" .….>。 

在 这 里 要 注意 由 于 不 同 数据 库 对 字符 串 字 段 的 大 小 限制 不 一 样 ， 所 以 在 设置 max_length 
的 时 候 要 考虑 自己 的 数据 库 特 性 。 

对 于 超 长 的 字符 串 ， 建 议 使 用 TextField 类 型 。 

5. DateField 

日 期 类 型 ， 对 应 Python 中 的 datetime.date 类 型 。 该 字段 类 型 包含 以 下 几 个 可 选 参数 。 

DateField.auto now， 如 果 指 定 了 该 属性 ， 那 么 每 当 保存 数据 时 都 会 将 该 字段 值 更 新 为 当 
前 时 间 。 不 像 默 认 值 ， 标 记 为 auto_now 的 字段 值 是 不 能 被 重 写 的 。 只 有 在 Model.SaveO 的 
时 候 才 会 被 更 新 。 

DateField.auto now_add， 与 auto now 类 似 ， 不 过 只 有 当 该 行 数据 第 一 次 创建 时 才 会 保 
存 当 前 时 间 。 不 像 默 认 值 ， 标 记 为 auto now add 的 字段 值 是 不 能 被 重 写 的 。 

如 果 将 日 期 类 型 字段 的 auto now 或 者 auto. now. add 属性 设置 为 True， 那么 字段 的 
editable 属性 会 被 自动 设置 为 False， 同 时 blank 属性 会 被 自动 设置 为 True。 

auto now, auto now_add 和 default 三 个 参数 只 能 单独 存在 ， 不 能 搭配 设置 ， 否 则 会 引 
起 异常 。 

auto now, auto now add 属性 总 是 使 用 TIME ZONE 中 设置 的 时 区 保存 时 间 ， 如 果 想 使 
用 其 他 时 区 ， 则 不 应 该 设置 这 两 个 属性 。 

示例 : 


date field = models.DateField(default-datetime.datetime.now()) 


显示 效果 如 图 18-1 所 示 。 
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日 历 图 表 后 ， 弹 出 日 历 控件 ， 如 图 18-2 所 示 。 


5x8 

Date field: 2171215 SRI 是 天 | 今天 | 明天 
取消 

图 18-1 图 18-2 


6. DateTimeField 
日 期 时 间 类 型 ， 对 应 Python 中 的 datetime.datetime 类 型 。 与 DateField 一 样 ， 包 含 两 个 
额外 参数 auto now 和 auto now add. 
默认 情况 下 ，DateTimeField 对 应 HTML 的 文本 框 : <input type="text" ...>, E Admin 后 
台 页 面 则 使 用 两 个 文本 框 显示 DateTimeField 字段 。 

示例 : 


date time field = models.DateTimeField(default-datetime.datetime.now()) 


显示 效果 如 图 18-3 所 示 。 
单 击 钟表 图 表 后 ， 弹 出 预 设 时 间 选 择 控件 ， 如 图 18-4 所 示 。 


| 


选择 一 个 时 间 


现在 
午夜 
上 午 6 点 
Date time field: 日 期 : 2071/21/5 SZI 正午 
下 午 6 点 
取消 


时 间 : 14:45 REIO 


图 18-3 图 18-4 


7. DecimalField 

指定 小 数位 数 的 数值 类 型 ， 对 应 Python 的 Decimal 类 型 。 

该 字段 类 型 包含 两 个 必要 参数 : 

DecimalField.max digits ， 数 值 的 总 位 数 ， 例 如 123.45 就 是 5 位 。 
DecimalField.decimal places， 小 数 点 后 位 数 。 
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例如 ， 设 置 一 个 字段 的 最 大 值 为 999， 同 时 包含 两 位 小 数 : 


DecimalField 对 应 HTML 的 文本 框 : <input type="number" ... 


示例 : 
| decimal feld = models.Decimalrield(max digits-5, decimal places-2, default-0.00) | 
显示 效果 如 图 18-5 所 示 。 
8. EmailField 
本 质 就 是 CharField， 不 过 会 验证 输入 的 字符 串 是 不 是 一 个 有 效 的 邮件 地 址 。 
示例 : 
| email field = models.BmailField(defeult-'testétest,com") | 
显示 效果 如 图 18-6 所 示 。 
Decimal field: [00 Email field: | testQtest com 
18-5 图 18-6 
9. FileField 
文件 上 传 控件 。 


该 字段 不 允许 使 用 primary. key 属性。 包含 两 个 可 选 参数 ， 
FileField.upload to， 文 件 上 传 后 的 保存 位 置 ， 例 如 : 


FileField.storage， 负 责 文 件 存储 的 Python 类， 用 于 存储 和 提取 文件 ， 类 django.core. 
files.storage.FileSystemStorage 提供 了 基本 的 文件 管理 功能 。 例 如 下 面 代 码 ， 无 论 在 settings. 
py 里 面 如 何 设置 MEDIA_ROOT 都 会 按照 fs 所 指定 的 路 径 存储 被 上 传 的 文件 : 
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示例 : 
显示 效果 如 图 18-7 所 示 。 
File Field: 未 选择 任何 文件 
图 18-7 


10. FilePathField 

文件 列表 显示 字段 ， 该 字段 接收 一 个 必 选 参数 以 及 一 个 可 选 参数 。 

口 必 选 参数 ， 

FilePathField.path， 当 前 路 径 下 的 文件 将 会 显示 在 下 拉 列 表 中 。 注 意 路 径 分 隔 符 是 “/”。 

口 可 选 参数 ， 

FilePathField.match， 一 段 正则 表达 式 ， 用 于 过 滤 FilePathField.path 中 的 文件 ， 注 意 该 正 
则 表达 式 只 能 过 滤 文 件 名 ， 不 能 过 滤 路 径 。 

FilePathField.recursive， 参 数值 为 True 或 False。 当 参数 设置 为 True Hf, FilePathField. 
path 的 子 文件 夹 中 符合 条 件 的 文件 也 会 显示 在 下 拉 列 表 中 ， 否 则 只 显示 当前 文件 夹 中 的 文 
件 ， 默 认 值 为 True。 

FilePathField.allow_files ， 参 数值 为 True 或 False. 

可 以 从 下 面目 录 结 构 查看 FilePathField 显示 效果 : 


miss m 231 | NS: 


示例 1: 


file path field — models.FilePathField(path-'D:/File/file path', match-'.jpg$', 
recursive-False, allow files-True, allow folders-False) 


显示 效果 如 图 18-8 所 示 。 
示例 2: 


file path field = models.FilePathField(path-'D:/File/file path', match-'.jpg$', 
recursive-True, allow files-True, allow folders-False) 


显示 效果 如 图 18-9 Brzn o 


File path field- File path field \cssjpg M 


css Jpg Vinux jpg | 
linuxjpg | \Django\Django jpg. 
图 18-8 图 18-9 


D 文件 的 绝对 路 径 会 显示 在 HTML 代码 中 ， 会 导致 一 定 的 安全 隐患 ， 因此 需要 谨慎 使 ; 
用 FilePathField 对 象 。 | 
口 FilePathField 在 数据 库 中 使 用 varchar 类 型 存储 ， 默 认 最 大 长 度 为 100 字符 。 | 


11. FloatField 
浮 点 数 类 型 ， 对 应 Python 的 float 类 型 。 


12. ImageFleld 

包含 FileField 字段 的 全 部 属性 与 方法 ， 但 是 仅 允 许 上 传 图 片 类 型 文件 。 
为 了 设置 图 片 显示 的 高 度 与 宽度 ，ImageField 字段 额外 提供 两 个 属性 : 
ImageField.height field， 图 片 高 度 。 

ImageField.width field, [5| Fr SEE 


13. IntegerField 
整数 字段 ， 取 值 范围 : -2147483648 ~ 2147483647. XFA Django 支持 的 数据 库 来 
说 都 是 安全 的 。 


14. PositivelntegerField 
正 整 数 类 型 ， 取 值 范围 : 0 ~ 2147483647. 
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15. PositiveSmallIntegerField 

小 正 整数 类 型 ， 取 值 范围 : 0 ~ 32767. 

16. SlugField 

Slug 是 用 于 新 闻 业 的 专业 名 词 ，slug 是 一 个 简短 的 文本 ， 只 人 允许 包含 字母 、 数 字 、 下 
画 线 和 连 字 符 。 与 CharField 相似 ， 可 以 指定 max length 属性 ， 如 果 没 有 显 式 地 给 出 max 
length 值 ， 默 认 值 为 50。 

如 果 想 在 SlugField 字 段 中 使 用 除 AScI 之 外 的 其 他 Unicode 字 符 ， 可 以 将 属性 
SlugField.allow_unicode 设置 为 True。 


17. SmallintegerField 

小 整数 类 型 ， 取 值 范围 : -32768 ~ 32767. 
18. TextField 

超 长 文本 类 型 。 

示例 ， 

text field = models.TextField(default-'') 


显示 效果 如 图 18-10 所 示 。 


Text field: 


图 18-10 
19. TimeField 
时 间 类 型 ， 对 应 datetime time。 


20. URLField 
CharField 类 型 ， 只 能 接收 URL 字符 串 ， 默 认 最 大 长 度 是 200 字符 。 


EZI Brut 


每 一 个 字段 都 需要 一 系列 属性 ， 例 如 使 用 CharField 时 必须 给 出 max length 属性 值 ， 除 了 
以 上 特殊 字段 属性 外 ，Django 还 为 所 有 字段 提供 了 一 系列 通用 属性 ， 这 些 属 性 都 是 可 选 属性 。 
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接 下 来 详细 介绍 字段 通用 属性 。 
18.4.1 null 


默认 值 为 True， 此 时 保存 模型 时 ，Django 会 在 数据 库 的 对 应 字段 中 保存 空 。 
对 于 文本 型 字段 ， 尽 可 能 不 使 用 null 属性 ， 因 为 当 使 用 默认 值 null 时 ， 数 据 库 中 就 可 能 
出 现 两 种 空 数据 : NULL 和 空 字符 串 ， 而 Django 默认 使 用 空 字符 串 。 


18.4.2 blank 


默认 值 为 False， 当 设置 Field.blank=True 时 字段 值 允 许 为 空 。 
注意 与 Field.null 属性 不 同 的 是 ，null 只 是 表示 数据 库 值 而 blank 用 于 表单 验证 ， 当 字段 属性 
blank-True 时 ， 表 单 验 证 将 允许 字段 值 为 空 ， 但 是 当 blank=False 时 ， 表 单字 段 将 变 成 必 填 字段 。 


18.4.3 choices 


属性 值 为 一 个 可 迭代 对 象 ， 如 列表 或 者 元 组 ， 迭 代 对 象 的 每 个 成 员 包括 两 个 字符 串 。 当 
字段 设置 了 choices 属性 时 ， 字 段 在 网 页 中 将 会 以 下 拉 列 表 的 形式 显示 。 

列表 或 元 组 的 第 一 个 值 将 作为 字段 值 保存 到 数据 库 中 ， 第 二 个 值 用 于 提高 字段 的 可 读 性 。 

示例 1: 


显示 效果 如 图 18-11 所 示 。 


Year in school- 
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示例 2: 


显示 效果 如 图 18-12 所 示 。 
示例 3: 
修改 示例 2， 设 置 字段 blank 属性 为 True: 


显示 效果 如 图 18-13 所 示 。 


图 18-12 图 18-13 


示例 4: 
修改 示例 2， 在 元 素 MEDIA. CHOICES 中 添加 成 员 (None, 'Please Select Media'): 
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显示 效果 如 图 18-14 所 示 。 


18-14 


18.4.4 default 


设置 字段 默认 值 。 属 性 值 可 以 是 字符 串 也 可 以 是 方法 。 默 认 值 不 可 以 是 可 变 对 象 ， 如 
列表 。 


18.4.5 help. text 


HTML 元 素 的 提示 文本 ， 在 文本 中 可 以 使 用 HTML 标记 。 
示例 : 


显示 效果 如 图 18-15 所 示 。 


Group choice field: | Please Select Media. Y 
Please select your favorite media 


图 18-15 
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18.4.6 primary key 


将 字段 设置 为 数据 表 主 键 。 如 果 模 型 中 任何 字段 都 不 包含 primary key-True 属性 ， 
Django 将 会 自动 为 模型 添加 一 个 IntegerField 字段 作为 主键 。 
主键 永远 是 只 读 的 ， 当 修改 一 个 模型 对 象 的 主键 后 ， 如 果 保 存 将 会 在 数据 库 中 创建 一 个 
新 对 象 。 


18.4.7 unique 


当 字 段 的 unique 属性 设置 为 True 时 ， 该 字段 的 所 有 值 在 整 张 数据 表 中 不 能 重复 ， 每 一 
行 数据 都 必须 有 唯一 的 字段 值 。 


18.4.8 verbose_name 


verbose name 属性 类 似 于 字段 的 说 明 。 

除了 ForeignKey、ManyToManyField、OneToOneField 三 种 字段 类 型 外 ， 其 他 字段 类 
型 都 包含 一 个 默认 的 verbose name 属性 ， 可 以 直接 在 字段 属性 列表 的 第 一 位 输入 文本 作为 
verbose name 属性 值 。 如 果 没 有 给 出 verbose name 属性 ,Django 会 使 用 字段 名 作为 verbose_ 
name 值 ， 如 果 字 段 名 中 包含 下 画 线 时 ， 下 画 线 会 被 转换 为 空格 。 

ForeignKey, ManyToManyField, OneToOneField 三 种 字段 类 型 要 求 第 一 个 参数 必须 是 
模型 类 ， 因 此 必须 使 用 verbose name 关键 字 。 

示例 : 


date field = models.DateField('This is publish day', default=datetime.datetime.now()) 
key = models.ForeignKey(Question, verbose name-'Foreign key') 


EJ 胡 与 考 之 问 的 关系 


关系 型 数据 库 的 表 与 表 之 间 往 往 存在 一 定 的 关系 ， 由 于 Django 的 模型 是 数据 库 表 与 
Python 类 之 间 的 映射 ， 因 此 Django 提供 了 对 3 种 最 常用 的 数据 库 表 之 间 关 系 的 支持 : 多 对 
一 、 多 对 多 、 一 对 一 。 


18.5.1 多 对 一 关系 


多 对 一 关系 是 一 张 数据 表 中 的 多 条 记录 与 另 一 张 数 据 表 中 的 一 条 记录 相关 的 关联 模式 。 
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在 关系 型 数据 库 中 通常 使 用 外 键 来 表示 多 对 一 关系 ，Django 模型 中 的 ForeignKey 字段 就 是 
模型 的 外 键 。 

与 其 他 模型 字段 的 使 用 基本 相同 ， 唯 一 不 同 之 处 是 FoieignKey 字段 的 第 一 个 参数 是 与 当 
前 模型 相关 的 类 。 例 如 ， 前 面 示例 代码 中 的 Choice 类 的 外 键 是 Question 25: 


class Question (models.Model): 


class Choice (models.Model): 
question = models.ForeignKey (Question, on delete-models.CASCADE) 


在 问卷 调查 系统 中 ， 每 一 个 调查 问卷 都 可 以 包含 多 个 选项 ， 而 每 一 个 选项 只 能 属于 一 个 
调查 问卷 ， 因 此 选项 与 问卷 之 间 就 形成 了 多 对 一 的 关系 。 
在 数据 库 中 查看 polls_choice 表 结 构 ， 如 图 18-16 所 示 。 


三 om Ber bsr imuee + 二 插入 栏 位 “三 日 除 栏 位 Pze 个 上 移 由 下 移 
[ee |æ [se [wsm[mm [sm |somus 

名 类 型 长 度 WBA RE null 

id int nu 0 m P1 

choice text varchar 200 0 

votes int nu 0 a 
b question id int 11 0 贺 

图 18-16 


虽然 在 模型 Choice 中 并 没有 定义 question id 字段 ,但 是 Django 自动 创建 了 question id 
字段 作为 Choice 的 外 键 。 


18.512 ”多 对 多 关系 


男 一 种 比较 常见 的 数据 库 表 之 间 的 关系 是 多 对 多 关系 ， 如 用 户 和 用 户 组 之 间 的 关系 通常 
就 是 多 对 多 关系 ， 例 如 一 家 公司 有 很 多 员工 ， 每 一 个 员工 都 属于 一 个 或 多 个 部 门 ， 每 个 部 门 
又 会 包括 一 个 或 多 个 员工 ， 此 时 员工 与 部 门 之 间 就 构成 了 多 


对 多 的 关系 。 irum Lacew 
图 18-17 是 一 张 简单 的 人 力 资源 表 ， 表 中 的 公司 有 3 [ERR dx 

ABI]. 销售 部 、 研 发 部 、 管 理 部 ， 其 中 销售 部 的 都 总 与 研发 ”| 人 全 部 一 小生 

部 的 郑 总 又 同时 属于 公司 管理 部 。 CEAS io 
此 时 可 以 通过 ManyToManyField 字段 类 型 实现 以 上 组 织 mus Hx 


架构 : 图 18-17 
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Django 自 带 的 Auth 模块 中 存在 大 量 多 对 多 的 数据 关系 ， 例 如 用 户 与 用 户 组 之 间 、 用 户 
与 用 户 权限 之 间 、 用 户 组 与 用 户 权限 之 间 就 是 多 对 多 关系 。 对 于 多 对 多 关系 ，Django 会 在 
数据 库 中 额外 创建 一 张 关 系 表 ， 关 系 表 的 命名 规则 是 : 应 用 程序 名 _ 模 型 1 名 _ 模 型 2 名 s， 
例如 用 户 与 用 户 组 的 关系 表 就 叫 作 auth_user_ groups， 数 据 库 中 查看 auth. user groups 表 结 
构 ， 如 图 18-18 所 示 。 


三 m Berb» .imeec Himen eimeco Pre 个 上 移 由 下 移 
eu 
hn 类 型 长 度 4E F null 
IEEE - u o E 
user id int 11 0 
group id int 1 0 
图 18-18 

在 Django 中 使 用 多 对 多 关系 时 ， 有 以 下 几 条 建议 : 

口 多 对 多 字段 名 使 用 复数 形式 。 

O 可 以 在 两 个 有 多 对 多 关系 的 模型 中 的 任意 一 个 模型 中 定义 多 对 多 字段 ， 但 是 不 能 同时 

在 两 个 模型 中 都 定义 多 对 多 字段 。 
18.5.3 ”一 对 一 关系 


这 种 映射 关系 用 得 比较 少 ，Django 使 用 OneToOneField 表示 一 对 一 关系 。 

一 对 一 关系 的 一 个 比较 常用 的 场景 是 根据 一 张 表 的 主键 对 这 张 表 进行 扩展 ， 例 如 对 
Django 自 带 的 user 表 进 行 扩展 ， 为 每 一 个 用 户 数据 添加 额外 信息 。 

与 前 两 种 关系 字段 的 使 用 相同 ，OneToOneField 也 要 求 第 一 个 参数 是 模型 类 名 。 


A 模型 元 属性 


元 属性 是 “模型 中 任意 非 模型 字段 的 内 容 "， 例 如 排序 功能 、 数 据 表 名 、 人 类 可 读 的 名 
字 (单数 形式 和 复数 形式 )， 所 有 元 属性 都 是 可 选 的 。 
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通过 在 模型 中 添加 一 个 叫 作 Meta 的 子 类 ， 定 义 模型 元 属性 。 
在 详细 介绍 模型 元 属性 之 前 ， 先 看 一 下 如 何在 Django 模型 中 使 用 元 属性 : 


通过 设置 元 属性 ， 上 面 Ox 模型 将 会 默认 使 用 horn length 排序 ， 在 Admin 页 面 显示 的 
复数 形式 名 字 叫 Oxen。 


1. abstract 


如 果 设 置 abstract = True， 当 前 模型 将 成 为 一 个 抽象 类 。 例 如 


2. app label 
如 果 模 型 定义 没有 注册 到 INSTALLED_ APPS， 那 么 就 必须 使 用 app_label 选项 在 Meta 
类 指定 所 属 的 应 用 程序 名 字 。 


3. db table 

当前 模型 所 使 用 的 数据 表 名 。 

默认 情况 下 ，Django 会 自动 根据 应 用 程序 名 + 模型 名 生成 数据 表 名 。 例 如 前 面 示例 代码 
中 的 polls 应 用 程序 ， 生 成 的 数据 表 叫 作 polls question, polls choice. 

如 果 觉 得 Django 自动 生成 的 表 名 不 好 看 ， 那 么 可 以 通过 db table 来 重新 定义 表 名 。 在 
这 里 即使 表 名 不 合法 也 没关系 ，Django 会 蔡 我 们 处 理 它 ， 不 过 最 好 还 是 使 用 合 规 的 名 字 。 


4. Ordering 
默认 的 排序 字段 ， 当 从 数据 库 中 查找 数据 时 会 按照 Ordering 指定 的 字段 排序 显示 。 
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该 属性 是 一 个 元 组 、 列 表 或 者 查询 表达 式 ， 每 一 个 元 组 或 列表 的 元 素 就 是 一 个 字段 名 ， 
默认 是 正 序 排序 ， 如 果 给 字段 名 前 添加 一 个 “-” 符 号 则 会 按照 倒序 排序 。 如 果 在 字段 名 前 
面 加 “?” 的 话 就 会 随机 提取 数据 。 

例如 ， 按 照 pub_date 倒序 author 正 序 查找 数据 : 


| Ordering = ['-pub date", "authort] 0000 
TE Django 2.0 中 增加 了 对 查询 表达 式 的 支持 ， 例 如 根据 author 字段 进行 排序 ， 当 author 
字段 值 为 null 时 ， 数 据 放 在 最 后 显示 : 


5. Indexes 


用 来 定义 数据 库 索 引 ， 形 式 如 下 : 


6. unique together 


为 数据 库 表 设置 联合 主键 ， 形 式 如 下 : 


联合 主键 是 一 个 由 元 组 组 成 的 元 组 ， 每 一 个 元 组 中 的 字段 在 数据 库 中 的 值 的 组 合 必须 是 
唯一 的 。 
如 果 只 有 一 个 联合 主键 ， 可 以 简化 unique_together， 例 如 : 


7. verbose name 
便于 人 类 读 取 的 模型 名 称 ， 单 数 形式 。 
代码 形式 如 下 : 
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如 果 没 有 指定 verbose name, Django 会 根据 模型 类 名 自动 创建 verbose name， 如 模型 
CamelCase 对 应 的 verbose name 为 camel case. 


8. verbose name plural 
便于 人 类 读 取 的 模型 名 称 ， 复 数 形式 。 
代码 形式 如 下 : 


如 果 没 有 指定 verbose name plural 的 话 ，Django 会 自动 生成 ， 形 式 为 : verbose name + 


18.7 | Manager 属性 


Manager 是 Django 模型 最 重要 的 属性 ， 通 过 使 用 Manager 模型 才 可 以 操作 数据 库 。 默 
认 情 况 下 ，Django 会 为 每 一 个 模型 提供 一 个 名 为 objects 的 Manager 实例 。Manager 属性 只 
能 通过 模型 类 访问 。 


18.7.1 自 定义 Manager 类 


默认 情况 下 可 以 使 用 Model.objects 所 提供 的 方法 操作 数据 库 ， 也 可 以 实现 自 定义 
Manager 类 : 


此 时 查找 数据 的 方式 如 下 : 


ersonpeopleal0 000000 
18.7.2 ”直接 执行 SQL 语句 


虽然 Manager 类 非常 强大 ， 但 是 有 些 情 况 下 我 们 仍然 希望 自己 手写 SQL 语句 。 对 此 
Django 提供 了 以 下 两 种 方法 允许 开发 人 员 直接 执行 SQL 语句 。 
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1. 使 用 Manager.raw() 方法 
Manager.raw() 方法 可 以 用 来 执行 一 段 SQL 语句 并 返回 Django 模型 实例 。 
语法 : 


Manager.raw(raw query, params-None, translations-None) 


raw() 方 法 返回 一 个 django.db.models.query.RawQuerySet 3: f], RawQuerySet 与 前 面 的 
QuerySet 一 样 可 以 被 循环 遍历 
图 18-19 是 一 个 在 Shell 中 使 用 raw0 方法 查看 全 部 博客 文章 的 例子 


图 18-19 

虽然 Django 允许 用 户 在 raw0 方法 中 执行 任意 SQL 语句 ， 但 是 Django 希望 SQL 语句 
能 够 返回 一 行 或 多 行 数据 ， 如 果 执 行 结束 没有 返回 任何 数据 ，raw0 方法 将 会 抛 出 异常 

Manager.raw() 方法 能 够 自动 将 查询 结果 转换 为 对 应 的 模型 ， 即 使 在 查询 语句 中 使 用 了 
AS 关键 字 对 字段 名 进行 了 修改 也 没关系 ， 只 要 数据 库 中 的 字段 名 与 模型 字段 匹配 成 功 即 可 ， 
如 图 18-20 所 示 

Manager. id 方法 所 执行 的 SQL 语句 中 除了 可 以 
包含 模型 字段 外 ， 还 可 以 包含 其 他 聚合 函数 值 ， 如 在 查 
找 全 部 博客 文章 时 顺便 输出 文章 名 字 所 包含 的 字符 数 
(length 是 MySQL 函数 )， 如 图 18-21 所 示 图 18-20 


“select *,length(name) as 1 from blog blog” 


图 18-21 
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Manager.raw() 方法 还 可 以 对 SQL 语句 进行 参数 化 ， 参 数 可 以 是 列表 或 者 字典 ， 如 图 
18-22 (a) 或 图 18-22 (b) 所 示 。 


* from blog blog whe 


2， 脱 离 模型 ， 直 接 执行 SQL 

由 于 Manager.raw() 的 执行 结果 总 是 对 应 一 个 模型 ， 而 真正 软件 产品 中 不 只 是 查询 单个 
模型 ， 还 会 有 更 复杂 的 情况 ， 例 如 执行 更 新 、 删 除 、 插 入 等 操作 。 因 此 我 们 需要 跳出 模型 系 
统 而 直接 执行 SQL 语句 

django.db.connection 对 象 提供 了 数据 库 连 接 操作 ， 使 用 connection.cursor0 方法 可 以 得 
到 一 个 游标 对 象 ，cursor.execute(sql, [params]) 方法 用 于 执行 指定 的 SQL 语句 。 使 用 cursor. 
fetchone() 或 者 cursor.fetchall() 方法 可 以 得 到 一 个 或 全 部 结果 

示例 : 


from django.db import connection 


def my custom sql(self): 
with connection.cursor() as cursor: 
cursor.execute("UPDATE bar SET foo - 1 WHERE baz - $s", [self.baz]) 
cursor.execute("SELECT foo FROM bar WHERE baz = $s", [self.baz]) 
row — cursor.fetchone() 


return row 
如 果 当 前 工程 包含 多 个 数据 库 ， 可 以 使 用 django.db.connections 对 象 获 取 数 据 库 连接 ， 
例如 连接 数据 库 polls 可 以 使 用 connections['polls']。 
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e 


:注意 的 是 ，cursor 所 返回 的 数据 只 是 数据 库 中 所 有 字段 的 值 ， 也 就 是 一 个 数值 的 列 
j 不 是 一 个 同时 包含 字段 名 与 字段 值 的 字典 ， 为 了 使 返回 的 数据 更 方便 使 用 ， 可 以 使 用 
面 方法 将 返回 结 RAUS 


EE 


下 


def dictfetchall (cursor): 
"Return all rows from a cursor as a dict" 
columns = [col[0] for col in cursor.description] 
return [ 
dict(zip(columns, row)) 
for row in cursor.fetchall() 


] 
在 Shell 中 重新 执行 查询 操作 ， 如 图 18-23 所 示 


图 18-23 


3. 执行 存储 过 程 
语法 : 
CursorWrapper.callproc (procname, params=None, kparams=None) 


注意 ， 只 有 Oracle 支持 kparams 参数 
示例 : 


with connection.cursor() as cursor: 
cursor.callproc('test procedure', [1, 'test']) 


数据 增删 改 查 


软件 系统 的 基本 操作 就 是 对 数据 的 增删 改 查 ，Django 通过 模型 以 及 QuerySet API 为 用 户 
提供 了 丰富 的 数据 库 操作 方法 。 
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e 


:注意 的 是 ，cursor 所 返回 的 数据 只 是 数据 库 中 所 有 字段 的 值 ， 也 就 是 一 个 数值 的 列 
j 不 是 一 个 同时 包含 字段 名 与 字段 值 的 字典 ， 为 了 使 返回 的 数据 更 方便 使 用 ， 可 以 使 用 
面 方法 将 返回 结 RAUS 


EE 


下 


def dictfetchall (cursor): 
"Return all rows from a cursor as a dict" 
columns = [col[0] for col in cursor.description] 
return [ 
dict(zip(columns, row)) 
for row in cursor.fetchall() 


] 
在 Shell 中 重新 执行 查询 操作 ， 如 图 18-23 所 示 


图 18-23 


3. 执行 存储 过 程 
语法 : 
CursorWrapper.callproc (procname, params=None, kparams=None) 


注意 ， 只 有 Oracle 支持 kparams 参数 
示例 : 


with connection.cursor() as cursor: 
cursor.callproc('test procedure', [1, 'test']) 


数据 增删 改 查 


软件 系统 的 基本 操作 就 是 对 数据 的 增删 改 查 ，Django 通过 模型 以 及 QuerySet API 为 用 户 
提供 了 丰富 的 数据 库 操作 方法 。 
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当 创建 好 模型 后 ， 就 可 以 立即 进行 添加 、 删 除 、 更 新 、 查 找 操作 了 ， 下 面 通过 一 个 例子 
来 展示 如 何 直 接 使 用 Django 模型 类 进行 数据 操作 。 
继续 使 用 MySite 工程 ， 在 工程 下 创建 一 个 blog 应 用 程序 : 


首先 创建 一 个 Blog 模型 : 


接 下 来 创建 一 个 用 于 添加 博客 文章 的 视图 ， 每 次 访问 视图 的 时 候 都 会 创建 一 篇 新 的 博客 
文章 ， 并 且 将 新 的 博客 文章 传 给 模板 显示 。 


添加 模板 create .html， 在 模板 中 显示 文章 内 容 。 


添加 CSS 样式 : 
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在 浏览 器 中 访问 该 视图 ， 如 图 18-24 所 示 。 


三 -oO x 
€ © 9- | O htpV/1270018000/blog/create/Diango 介 绍 /Django 是 基于 Python 开具 的 WeblER/ $ yr -| xe Y 


| O | D My amazingste — x WE 


图 18-24 


以 上 通过 非常 简单 的 几 行 代码 就 完成 了 数据 添加 操作 ， 那 么 数据 是 不 是 真 的 写 入 数据 库 
了 呢 ? 打开 数据 库 ， 可 以 看 到 确实 完成 了 创建 新 博客 的 工作 ， 如 图 18-25 所 示 。 


mess Baz- Y xm Due Gm Baa 


name body 
Django 介 绍 Dijango 是 基于 Python 开发 的 Web 框 某 
18-25 


下 面 使 用 Django objects 接口 分 别 实 现 查找 指定 文章 以 及 全 部 文章 的 视图 。 
创建 一 个 index 视图 用 于 显示 全 部 文章 。 
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创建 index.html 模板 : 


添加 URL: 


打开 浏览 器 查看 视图 ， 如 图 18-26 所 示 。 


ze- ox 
€ Q 9- Q htpy/12700.8000/bloo/ — f yx - | X Ar| 


O j D My amazing site — x We 


图 18-26 
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上 面 视图 会 显示 全 部 博客 信息 ， 实 际 工 作 中 我 们 往往 需要 显示 指定 的 某 一 篇 文章 ， 下 面 
创建 一 个 SearchBlog 视图 : 


创建 detail.html 模板 : 


添加 URL: 


在 浏览 器 里 面 查看 ， 如 图 18-27 所 示 。 


zuw-usxrx 
€ Q 9- Qntp/127001800/009/2/ $ yx ~| x. Yt. 


| 合 D Myamaingblog x (o 


18-27 
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下 面 编写 UpdateBlog 视图 用 于 更 新 指定 文章 : 


添加 URL: 
| path (r'update/<int:id>/<str:title>/<str:body>/', views.UpdateBlog, names'update'), 
在 浏览 器 中 访问 UpdateBlog 更 新 id 为 2 的 文章 ， 如 图 18-28 所 示 。 


€ © 9-|Q htp//1270018000/blog/update/2/Django%20 开 发 环境 从 “| xe Yr | 
Q j D Myamaingblg — x WE 


18-28 
最 后 来 看 看 删除 操作 ， 同 样 创建 一 个 视图 : 
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添加 URL: 


在 浏览 器 中 访问 DeleteBlog 并 删除 id 为 2 的 文章 ， 操 作 结 束 返 回首 页 显示 剩余 的 全 部 
文章 ， 如 图 18-29 所 示 。 


mt-ux 
€ Q 9- Qnp/1270018000/blog/delete/2 $ Yt - | 3e Yr 


Qr | D My amazing site x V 
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XJ 数据 操作 进 阶 一 一 QuerySets 


18.8 节 使 用 了 模型 的 objects 属性 完成 了 数据 的 增删 改 查 操作 ， 如 save0 all, filterO. 
get()、delete()， 这 些 方法 是 QuerySet 对 象 所 提供 的 最 常用 的 方法 。 模 型 类 的 Manage 接口 可 
以 创建 QuerySet 实例 ， 默 认 的 QuerySet 实例 名 为 objects。QuerySet 是 数据 库 中 一 系列 数据 
的 集合 ， 与 SQL 查询 语句 一 样 ，QuerySet 可 以 接收 0 个 、1 个 或 多 个 过 滤 条 件 。 

本 节 将 对 QuerySet 进行 详细 介绍 ， 本 节 实 例 代 码 如 下 : 
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18.9.1 更 新 ForeignKey 


更 新 模型 的 ForeignKey 字段 与 更 新 其 他 普通 字段 一 样 ， 只 需要 直接 给 ForeignKey 字段 
赋值 即 可 。 例 如 : 


代码 解读 : 

Entry.objects.get(pk=1): 在 数据 库 中 取得 主键 为 1 的 Entry。 
Blog.objects.get(name-"Cheddar Talk"); 在 数据 库 中 查找 name Jy “Cheddar Talk” 的 Blog. 
entry.blog = cheese blog: 更 新 entry 的 blog 属性 。 

entry.save(): 保存 新 Entry 对 象 。 


18.9.2 更 新 ManyToManyField 


由 于 ManyToManyField 字段 不 像 其 他 字段 一 样 可 以 直接 在 数据 表 中 保存 属性 
值 ，ManyToManyField 字段 需要 通过 一 张 关 系 表 来 保存 所 有 相关 联 的 数据 ， 所 以 更 新 
ManyToManyField 字段 的 方式 也 与 其 他 字段 不 完全 相同 。 

添加 一 个 外 键 : 
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添加 多 个 外 键 : 


18.9.3 ”数据 查询 
我 们 可 以 直接 使 用 QuerySet 对 象 的 all0 方法 查询 数据 表 中 的 全 部 数据 ， 如 : 


也 可 以 使 用 恰当 的 过 滤 方 法 查询 特定 数据 ， 下 面 是 Django 中 最 常用 的 数据 过 滤 语 句 。 


1. filter(**kwargs) 
返回 一 个 新 的 QuerySet 对 象 ， 新 对 象 只 包含 符合 过 滤 条 件 的 数据 。 


2. exclude(**kwargs) 

返回 一 个 新 的 QuerySet 对 象 ， 新 对 象 不 包含 符合 过 滤 条 件 的 数据 。 

前 面 过 滤 语 名 的 参数 **kwargs 与 SQL 脚本 中 的 WHERE 条 件 语句 一 样 用 于 过 滤 数 据 ， 
它们 在 QuerySet 对 象 方法 中 以 关键 字 参 数 的 形式 存在 ， 书 写 格式 为 : field lookuptype-value 
(注意 field 与 lookuptype 之 间 是 两 个 下 画 线 )。 例 如 ， 查 询 发 布 日 期 早 于 或 等 于 2016 年 1 月 
1 日 的 所 有 文章 : 


等 效 的 SQL 语句 如 下 : 


通常 ， 过 滤 语 句 中 的 feld 是 模型 的 字段 名 ， 唯 一 的 例外 情况 是 ForeignKey 字段 ， 如 果 
需要 通过 外 键 过 滤 数据 的 话 ， 则 需要 使 用 ForeignKey 字段 名 +“ _ id” 的 形式 。 例 如 ， 查 找 
所 有 博客 id 为 4 的 Entry 数据 : 


18.9.4 查询 条 件 


前 面 讲 到 QuerySet 的 查询 参数 的 书写 格式 为 feld_lookuptype=value， 其 中 lookuptype 是 
查询 条 件 ， 类 似 于 SQL 脚本 中 WHERE 语句 的 比较 运算 符 。 下 面 是 Django 自 带 的 查询 条 件 。 
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1. exact 
完全 匹配 运算 符 。 由 于 完全 匹配 的 使 用 频率 最 高 ， 所 以 Django 将 exact 定义 为 默认 查询 
条 件 ， 如 果 在 过 滤 语 句 中 没有 指定 查询 条 件 ， 那么 Django 将 按照 完全 匹配 查找 数据 ， 例 如 : 


等 价 于 


注意 ， 如 果 在 exact 运算 符 右 侧 指 定 None， 那 么 在 翻译 成 SQL 语句 时 就 会 按照 SQL 中 
的 NULL 进行 比较 。 
例如 下 面 的 Django 语句 : 


等 价 于 SQL 语句 : 


2. iexact 
等 同 于 exact 运算 符 , 但 是 不 区 分 字母 大 小 写 。 
例如 下 面 的 Django 语句 : 


等 价 于 SQL 语句 : 


注意 上 面 第 一 个 查询 语句 将 会 查找 到 所 有 包含 beatles blog 的 文章 ， 如 包含 Beatles Blog、 
beatles blog 和 BeAtLes BLoG 的 文章 。 


3. contains 
包含 查询 ， 区 分 字母 大 小 写 。 
例如 查找 标题 包含 Django 的 博客 : 


对 应 的 SQL 语句 : 
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注意 此 时 只 会 查找 到 标题 包含 Django 的 文章 ， 而 不 会 查找 包含 django 或 者 DJANGO 的 
章 。 


4. icontains 

等 同 于 contains 运算 符 , 但 是 忽略 大 小 写 。 

同样 使 用 上 面 的 查询 语句 ， 但 是 换 作 icontains 过 滤 条 件 将 会 检索 到 所 有 包含 Django 的 
文章 ， 而 不 关心 字母 的 大 小 写 形式 。 

5. in 

字段 值 存在 于 一 个 可 迭代 列表 中 ， 如 用 列表 、 元 组 等 。 等 价 于 SQL 的 IN 操作 。 

例如 : 


x 


等 价 于 : 


除 此 之 外 ，in 还 可 以 进行 更 复杂 的 对 象 比较 ， 例 如 : 


对 应 SQL 语句 : 


In 运算 符 还 可 以 和 values, values list 结合 使 用 ， 但 是 一 定 要 注意 此 时 values 和 values - 
list 只 能 接收 一 个 字段 ， 例 如 下 面 写法 是 合法 的 : 


而 下 面 写 法 就 是 非法 的 : 


在 此 ， 还 要 注意 性 能 问题 ， 很 多 数据 库 没有 对 混合 的 SQL 语句 进行 优化 ， 如 下 代码 可 
能 会 带 来 很 大 的 性 能 问题 。 


Django 推荐 使 用 values 方法 进行 查询 ， 并 且 将 复杂 的 查询 拆 分 为 多 个 简单 查询 。 
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(1) gt, gte, lt, Ite 

对 应 SQL PHJ >, >=, <, <=, 

(2) startswith 

字段 以 给 定 值 开始 ， 区 分 字母 大 小 写 。 
例如 下 面 的 Django 查询 语句 : 


对 应 SQL 语句 : 


( 3) istartswith 
等 同 于 startswith 运算 符 ， 但 是 忽略 字母 大 小 写 。 
例如 下 面 Django 查询 语句 : 


对 应 SQL 语句 : 


( 4) endswith 
字段 以 给 定 值 结束 ， 区 分 字母 大 小 写 。 
例如 下 面 Django 查询 语句 : 


对 应 SQL 语句 : 


( 5) iendswith 
等 同 于 istartswith 运算 符 ， 但 是 忽略 字母 大 小 写 。 
例如 下 面 的 Django 查询 语句 : 


对 应 SQL 语句 : 


(6 ) range 
字段 值 出 现在 一 个 区 间 中 。 
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例如 : 


对 应 SQL 语句 : 


(7) date, year, month, day, week day, hour, minute, second 


分 别 比 较 日 期 、 年 、 月 、 日 、 星 期 、 时 、 分 、 秒 ， 一 般 要 结合 gt、lt 等 运算 符 。 例 如 : 


( 8) quarter 

对 于 日 期 (date) 或 者 日 期 时 间 (datetime) 字段 ， 比 较 日 期 所 属 季节 ， 可 选 值 为 1.2、3、 
4， 分 别 代表 一 年 中 的 四 个 季节 。 

下 面 Django 语句 用 于 查找 发 布 于 第 二 季度 (4 H 1 H6 H 30 ED 的 所 有 文章 : 


(9) time 
比较 日 期 时 间 (datetime) 字段 的 时 间 部 分 ， 例 如 : 


( 10) isnull 
对 应 SQL 语句 的 IS NULL H IS NOT NULL， 可 接收 参数 值 为 True、False。 例 如 查找 
发 布 日 期 为 空 的 博客 : 


对 应 SQL 语句 : 


(11) regex 
使 用 正则 表达 式 过 滤 模型 字段 ， 注 意 区 分 正则 表达 式 中 的 字母 大 小 写 。 正 则 表达 式 将 应 
用 于 数据 库 中 ， 例 如 : 
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对 应 SQL 语句 : 


建议 在 正则 表达 式 前 使 用 r'” 防 止 字符 转 义 。 
(12) iregex 
等 同 于 regex 运算 符 ， 但 是 忽略 字母 大 小 写 。 例 如 : 


对 应 SQL 语句 : 


18.9.5 “模型 深度 检索 


SQL 查询 可 以 通过 使 用 JOIN 语法 跨越 多 张 数据 库 表 进行 检索 ， 而 Django 可 以 通过 模型 
之 间 的 关系 进行 深度 查询 。 如 本 章 示例 代码 中 ，Blog 是 Entry 的 外 键 ， 如 果 想 查询 所 有 Blog 
名 为 Beatles Blog 的 Entry， 可 以 使 用 以 下 代码 : 


| >>> Entry.objects.flter(blog mamee'Beatles Blog!) 000000 
代码 中 使 用 两 个 下 画 线 查找 blog 的 name 字段 ， 在 这 里 ，name 是 模型 Blog 的 字段 ， 而 
blog 是 Entry 的 字段 ， 此 时 name 与 Entry 之 间 通 过 “ ”建立 了 联系 。 
QuerySet 允许 进行 任意 深度 检索 ， 同 时 还 支持 反 向 检索 ， 作 为 反 向 查询 的 参数 时 ， 模 型 
的 名 字 必 须 使 用 小 写字 母 ， 如 entry。 以 查找 所 有 符合 条 件 的 博客 为 例 ， 这 些 博客 在 Entry 中 
至 少 有 一 条 记录 并 且 对 应 的 Entry 的 headline 字段 值 是 Lennon, Django 代码 如 下 : 


| >>> Blog.objects.flter(entry headline containse'ennon) 
如 果 进 行 多 层 查询 时 ， 中 间 模 型 没有 符合 条 件 的 数据 ，Django 会 按照 NULL 对 其 处 理 ， 
并 且 不 会 出 现任 何 异 常 。 
例如 ，Entry 表 中 存在 这 样 一 条 数据 : 它 的 blog 字段 指向 了 博客 表 中 的 一 条 真实 数据 ， 
它 的 authors 字段 为 空 。 此 时 使 用 下 面 语句 查询 Blog 时 ，Django 会 认为 authors 的 name 字段 
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为 空 ， 而 不 会 因为 authors 是 NULL 而 抛 出 异常 (NULL — name 是 错误 的 ): 


下 面 查询 语句 将 会 返回 所 有 作者 名 为 空 的 博客 : 


如 果 不 想 查找 作者 为 空 的 博客 ， 可 以 使 用 下 面 查询 代码 : 


18.0.06 ”多 条 件 查 询 


介绍 多 条 件 查 询 前 ， 先 来 创建 几 条 测试 数据 。 


1. 创建 4 篇 博客 文章 
创建 4 篇 博客 文章 ， 如 图 18-30 所 示 。 


2. 添加 一 个 作者 
添加 一 个 作者 ， 如 图 18-31 所 示 。 
| name tagline 
1 iiRDjango Django REF Python BRF AN- REOR W. 
2 Django EJALOIGETH , Django 按照 以 下 形式 命名 版 
ps 1. 安装 Python2. 安装 Django lic name email 
4 走 进 Django 的 世界 Django Lennon  Lennon@testcom 


图 18-30 图 18-31 


3. 创建 3 条 Entry 记录 
创建 3 条 Entry 记录 ， 如 图 18-32 所 示 。 


也-ibeedins ad r jd 
1 Lennon Django 是 基于 Python 语言 开发 的 :2015-12-08 
2 Lennon Django 推 荐 使 用 Python 3 进行 开发 2016-11-22 
3 Django AIRA 1. 安装 Python2. 安装 Django 2017-12-21 
4 走 进 Django 的 世界 。“ Django 是 一 款 基 于 BSD 协 议 并 完全 $2017-12-21 


图 18-32 
查询 所 有 符合 条 件 的 博客 ， 这 些 博客 在 Entry 表 中 包含 数据 : 1. headline 是 “ Lennon" 
的 Entry; 2. pub date 是 2017 年 的 Entry。 
查询 语句 : 


wne | 
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查询 结果 : 
没有 符合 条 件 的 博客 。 
查询 语句 : 


| Blog.cbjects.ilter(entry headline contains™"Tennon') „filter (entry pub date yeare2017) 

查询 结果 : 

查询 到 id 为 1 的 博客 文章 。 

代码 解释 : 

第 一 条 查询 语句 中 的 查询 条 件 是 逻辑 与 的 关系 ， 即 只 有 同时 满足 所 有 条 件 的 博客 才 会 被 
查询 出 来 。 而 第 二 条 查询 语句 可 以 被 认为 是 由 两 部 分 组 成 的 ， 该 语句 可 以 分 解 为 以 下 两 条 查 
询 语句 : 


其 中 temp 返回 所 有 Entry 的 headline 为 Lennon 的 博客 ， 本 例 中 符合 条 件 的 博客 的 id 是 
1 和 2。 

接 下 来 对 temo 进行 过 滤 ， 仅 查找 发 布 日 期 为 2017 年 的 博客 ， 由 于 id 为 2 的 博客 发 布 于 
2016 年 所 以 不 符合 条 件 。 

最 后 只 有 id 为 1 的 博客 被 检索 出 来 。 


18.9.7 F() 函数 


前 面 示例 代码 中 所 有 的 查询 条 件 都 是 将 一 个 模型 字段 与 常量 进行 比较 ,那么 如 何 将 同一 
个 模型 中 的 两 个 字段 进行 比较 呢 ? 为 此 Django 专门 提供 了 一 个 F 表 达 式 。 
例如 ， 查询 所 有 comments 数量 大 于 pingbacks 数量 的 博客 。 仍 然 以 上 面 的 数据 库 为 例 ， 
图 18-33 展示 了 数据 库 中 的 所 有 Entry。 
d ^ headline [blogid Incomments n pingbacks 
1 Lennon | EE 
2 Lennon 
3 搭建 Django 开 发 环境 
4 走 进 Django 的 世界 


wne o 
oO e wo 


boc Mon 


图 18-33 
创建 视图 : 
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创建 模板 : 


创建 URL: 


查询 结果 : 
查询 到 id 为 3 和 4 的 Entry， 如 图 18-34 所 示 。 


€ 3 © |O 127.0.0.1:8000/blog/fsearch/ 


18-34 


除了 直接 使 用 FO 也 数 外 ， 还 可 以 对 FO 进行 任意 数学 运算 ， 如 : 
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另外 在 FO 函数 中 也 可 以 使 用 两 个 下 画 线 进行 深度 查找 : 


最 后 FO 函数 还 支持 按 位 运算 ， 如 按 位 与 .bitand0)、 按 位 或 .bitor0、 按 位 左 
移 .bitrightshift()、 按 位 右 移 .bitleftshift()， 例 如 使 用 下 面 代码 修改 FSearch 视图 ,那么 视图 将 
只 能 查询 到 id 为 4 的 Entry: 


18.9.8 主键 查询 


为 了 代码 书写 方便 ，Django 提供 了 一 个 主键 查询 的 快捷 方式 ， 前 面 我 们 已 经 用 过 了 ， 这 
个 快捷 方式 就 是 pk， 在 查询 条 件 中 代表 当前 模型 的 主键 。 以 下 代码 是 等 价 的 : 


使 用 pk 时 并 不 限制 查询 条 件 ， 例 如 可 以 使 用 gt 查找 博客 : 


pk 还 可 以 用 在 深度 检索 中 : 


18.9.9 查询 条 件 中 的 % 和 _ 
SQL 查询 语句 中 的 “%” 和 “_” 有 着 特殊 意义 :“%” 匹 配 多 个 字符 ; “_ ”匹配 单 个 


字符 。 为 了 方便 使 用 ，Django 的 查询 语句 不 对 这 些 字符 进行 特殊 处 理 ， 例 如 查找 文字 是 否 包 
含 “%” 可 以 直接 编写 以 下 代码 : 


Django 后 台 会 将 以 上 代码 转换 为 如 下 SQL 查询 语句 : 


18.9.10 QuerySet 和 缓存 


第 一 次 创建 QuerySet 对 象 的 时 候 ，Django 不 会 为 QuerySet 生成 任何 缓存 。 而 当 第 一 次 
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执行 QuerySet 的 时 候 ，Dijango 会 将 查询 结果 进行 缓存 ， 后 续 的 查询 语句 都 可 以 使 用 当前 的 
缓存 内 容 。 

在 编写 查询 语句 时 ， 合 理 地 使 用 QuerySet 缓存 可 以 极 大 地 提高 代码 执行 效率 、 减 少 内 存 
使 用 ， 例 如 下 面 两 条 语句 将 会 访问 两 次 数据 库 并 生成 两 个 不 同 的 QuerySet 对 象 : 


通常 情况 下 ， 我 们 不 需要 这 么 频繁 地 读 取 数 据 库 ， 只 要 执行 一 次 查询 操作 即 可 ， 后 续 操 
作 只 需要 使 用 之 前 的 查询 结果 就 可 以 了 ， 因 此 对 以 上 代码 进行 如 下 修改 : 


上 面 第 二 行 代码 是 对 QuerySet 的 第 一 次 执行 ， 此 时 执行 结果 将 会 被 缓存 ， 当 第 二 次 执行 
时 ,操作 对 象 就 是 内 存 中 的 缓存 数据 了 ， 不 会 继续 读 取 数据 库 。 

需要 注意 的 是 ， 执 行 QuerySet 并 不 是 总 能 够 生成 缓存 。 当 QuerySet 的 执行 操作 只 影响 
QuerySet 的 一 部 分 数据 时 ， 系 统 将 不 会 生成 缓存 ， 这 种 情况 通常 会 出 现在 数组 的 切片 操作 以 
及 使 用 下 标 查 询 数组 时 ， 请 看 下 面 代码 : 


虽然 使 用 queryset[5] 执行 了 两 次 QuerySet 查询 ,但 是 这 两 次 操作 都 没有 进行 缓存 ， 也 
就 是 说 ， 两 次 操作 都 直接 进行 了 数据 库 查找 。 然 而 ， 如 果 QuerySet 操作 影响 到 整个 查询 结果 
的 话 ，QuerySet 将 会 被 缓存 ， 如 以 下 代码 : 


第 二 行 代码 [entry for entry in queryset] 遍历 了 整个 QuerySet， 此 时 Django 为 查询 结果 创 
建 缓存 ， 因 此 后 面 两 次 queryset[5] 操作 都 是 从 缓存 中 提取 数据 而 没有 直接 查找 数据 库 。 
除了 遍历 QuerySet 会 创建 缓存 外 ， 还 有 其 他 操作 也 会 创建 缓存 ， 如 : 
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18.9.11 复杂 查询 与 Q 对 象 
前 面 讲 的 所 有 查询 条 件 都 是 “逻辑 与 ”运算 ， 例 如 下 面 代码 就 是 两 个 条 件 的 “与 ”运算 ; 


对 于 复杂 查询 来 说 ， 只 有 “与 ”运算 就 不 够 了 ， 此 时 需要 使 用 Q 对 象 。Q 对 象 封装 了 一 
系列 关键 字 参 数 ， 这 些 关 键 字 参数 就 是 前 面 用 到 的 查询 条 件 。 
例如 下 面 的 Q 对 象 封装 了 一 个 LIKE 查询 : 


Q 对 象 之 间 可 以 使 用 “ &” 或 者 “ |” 运算 符 组 合 起 来 ， 多 个 Q 对 象 通过 运算 符 组 合 
起 来 之 后 形成 一 个 新 的 Q 对 象 ， 例 如 下 面 语句 将 会 返回 一 个 新 的 Q 对 象 用 于 question _ 
startswith 之 间 的 “逻辑 或 ”运算 。 


以 上 Q 对 象 等 价 于 下 面 的 SQL 语句 : 


对 于 复杂 查询 ， 可 以 使 用 括号 将 Q 对 象 进行 分 组 ， 另 外 Q 对 象 可 以 使 用 波折 线 (~) 进 
行 取 反 操作 ， 取 反 操 作 等 价 于 SQL 语句 中 的 NOT 运算 ,例如 ;: 


QuerySet 中 任何 查询 语句 (如 filter0 exclude), 、getO) 的 关键 字 参 数 都 可 以 使 用 Q 对 
象 替代 。 多 个 Q 对 象 之 间 使 用 “逻辑 与 ”运算 关联 ， 例 如 : 


上 面 的 getO 方法 接收 两 个 Q 对 象 : 


两 个 Q 对 象 之 间 使 用 “逻辑 与 ”运算 ， 近 似 的 SQL 语句 如 下 : 
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QuerySet 的 查询 语句 可 以 同时 接收 Q 对 象 和 关键 字 参 数 ， 所 有 参数 之 间 使 用 “让 
| 辑 与 ”运算 。 在 此 需要 注意 的 一 点 是 ， 如 果 查 询 语句 同时 接收 了 Q 对 象 和 关键 字 参数 ， 
那么 Q 对象 一 定 要 放置 在 关键 字 参 数 之 前 ， 例 如 : 


18.9.12 ”模型 比较 


与 Python 一 样 ，Django 的 模型 实例 支持 比较 运算 ， 比 较 运 算 符 用 “== ”表示 。 默 认 情 
况 下 ， 模 型 实例 是 对 主键 进行 比较 ， 以 下 两 种 书写 形式 是 一 样 的 : 


如 果 模 型 的 主键 不 是 “id” 也 没有 关系 ，Django 会 自动 识别 主键 并 进行 比较 。 
18.9.13 ”删除 操作 


可 以 使 用 deleteQ 函数 删除 一 个 或 多 个 模型 实例 ， 函 数 立 即 返 回 删 除 的 对 象 数量 以 及 每 
种 对 象 类 型 所 删除 的 数量 ， 例 如 : 


' Q 当 被 删除 的 对 象 是 其 他 模型 数据 的 外 键 时 ， 其 他 模型 中 相应 的 数据 也 会 被 删除 。 
O delete) 是 唯一 一 个 不 是 由 Manager 提供 的 方法 ， 这 样 可 以 在 一 定 程度 上 防止 用 户 ， 
i 不 小 心 使 用 Entry.objects.delete() 删除 全 部 数据 ， 如 果 用 户 确实 需要 删除 全 部 数据 : 
l 应 该 使 用 如 下 方式 : i 


第 18 齐 异型 265 [NN 


18.9.14 ”复制 模型 实例 


虽然 Django 没有 直接 提供 方法 来 复制 模型 实例 ， 但 是 可 以 通过 将 已 有 模型 实例 的 主键 
简单 设置 为 None 的 方式 创建 一 个 完全 一 样 的 新 对 象 实例 ， 例 如 : 


18.9.15 ”批量 更 新 


AEH update 方法 可 以 批量 更 新 数据 ， 例 如 将 所 有 发 布 日 期 为 2007 年 的 博客 的 headline 
修改 为 “过 期 文章 ”: 


如 果 批 量 更 新 外 键 字 段 ， 只 需要 给 外 键 字段 重新 赋值 一 个 实例 对 象 即 可 ， 例 如 : 


使 用 update( 更 新 数据 库 时 唯一 需要 注意 的 事情 就 是 ，update0 方法 只 能 更 新 当前 模型 
的 数据 。 例 如 下 面 代码 ， 虽 然 可 以 使 用 Blog 对 象 查找 Entry， 但 是 并 不 能 更 新 Blog 表 ， 只 能 


" 
u 


| dE updateQ 方法 中 也 可 以 使 用 FO 表达 式 ， 但 是 不 能 在 FO 表达 式 中 使 用 深度 查询 ， 
| 例如 下 面 的 代码 就 是 错误 的 : 


18.9.46 ”模型 关系 
在 Django 中 可 以 通过 模型 之 间 的 关系 查找 数据 。 下 面 继续 使 用 Blog. Author, Entry 模 
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型 讲解 如 何 利用 模型 之 间 的 关系 查询 数据 。 


1. 一 对 多 关系 
前 向 查询 : 通过 Entry 外 键 查询 Blog。 


反 向 查询 : 通过 Blog 查询 相关 的 Entry。 


注意 entry. set 同样 是 Manager 的 实例 ， 在 模型 中 查询 所 有 外 键 实例 时 可 以 使 用 FOO_set 
格式 的 Manager 实例 ， 其 中 FOO 是 模型 名 字 的 小 写 格式 。FOO_set 同样 返回 一 个 QuerySet。 


2.， 多 对 多 关系 
多 对 多 关系 中 ， 模 型 之 间 互 相 访问 的 方式 类 似 于 一 对 多 关系 中 的 反 向 查询 。 唯 一 的 区 别 
是 Manager 对 象 的 命名 方式 。 


上 面 是 Entry 和 Author 模型 的 定义 ， 其 中 Entry 中 定义 了 ManyToManyField 字段 。 此 时 
在 Entry 中 查询 Author 时 可 以 直接 使 用 Entry.authors.filter0) 的 方式 ， 而 如 果 通 过 Author 模型 
查找 Entry 的 话 必 须 使 用 “entry_set” 的 格式 。 

下 面 是 多 对 多 模型 中 的 查询 示例 : 


3. 一 对 一 关系 
一 对 一 关系 中 的 模型 的 查询 方式 与 多 对 多 关系 中 的 查询 方式 一 样 。 
假设 存在 一 个 模型 EntryDetail 与 Entry 是 一 对 一 关系 : 
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可 以 使 用 以 下 代码 查询 相应 模型 : 


这 里 与 多 对 多 关系 中 唯一 的 区 别 是 : 多 对 多 关系 中 查询 结果 是 QuerySet 而 一 对 一 关系 
中 的 查询 结果 是 模型 实例 。 例 如 上 面 的 ed.entry 返回 一 个 Entry 实例 ，e.entrydetail 返回 一 个 
EntryDetail 实例 。 


第 19 章 
视图 


Django 中 的 视图 就 是 一 个 Python 方法 ， 它 可 以 接收 一 个 Web request 对 象 并 向 客户 端 返 
回 一 个 Web response 对 象 。 在 视图 方法 中 可 以 进行 任意 的 业务 逻辑 处 理 ， 例 如 查询 数据 库 操 
TEARS 


EEI 视图 结构 
下 面 是 一 个 用 于 显示 当前 日 期 和 时 间 的 视图 : 


from django.http import HttpResponse 
import datetime 


def current datetime (request): 
now = datetime.datetime.now() 
html = "«html»«body»It is now $s.«/body»«/html»" $ now 
return HttpResponse (html) 


代码 解释 : 

首先 需要 导入 HttpResponse 包 用 于 向 客户 端 返回 Web response 对 象 。 

current_datetime 是 视图 方法 名 ， 每 一 个 视图 方法 的 第 一 个 参数 都 是 request 用 于 接收 客 
户 端 发 送 过 来 的 Web request。 

视图 方法 返回 HttpResponse 对 象 。 


DA HTTP 状态 处 理 


HTTP 请 求 包含 多 种 状态 ， 如 最 常见 的 404 错误 ，Django 对 此 提供 了 很 多 可 以 处 理 这 些 
状态 的 类 。 例 如 可 以 使 用 HttpResponseNotFound 处 理 404 错误 : 


return HttpResponseNotFound('«hl»Page not found«/hl»') 


Django 中 所 有 Web response 类 都 是 HttpResponse 的 子 类 ， 包括 如 表 19-1 所 示 的 几 种 。 
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表 19-1 

HTTP 状态 码 Response 
302 HttpResponseRedirect 
301 HttpResponsePermanentRedirect 
304 HttpResponseNotModified 
400 HttpResponseBadRequest 
404 HttpResponseNotFound 
403 HttpResponseForbidden 
405 HttpResponseNotAllowed 
410 HttpResponseGone 
500 HttpResponseServerError 


由 于 404 错误 比较 常见 ，Django 专门 提供 了 Http404 类 用 于 处 理 它 : 


from django.http import Http404 
from django.shortcuts import render 
from polls.models import Poll 


def detail(request, poll id): 
try: 
p = Poll.objects.get(pk-poll id) 
except Poll.DoesNotExist: 
raise Http404("Poll does not exist 


s) 


return render (request, 'polls/detail.html', ('poll': p)) 


快捷 方式 


19.3.1 render_to_string() 


在 前 面 的 视图 中 ,我 们 把 HTML 文档 写 在 了 一 个 变量 中 ,使 用 的 时 候 将 它 传递 给 


HttpResponse 对 象 : 


html = "«html»«body»It is now $s.«/body»c/html»" $ now 


return HttpResponse (html) 


这 样 做 虽然 没有 问题 ， 但 是 如 果 当 HTML 文档 非常 大 时 ， 就 会 导致 变量 内 容 很 长 ， 读 


写 困 难 。 对 此 首先 想到 的 解决 方案 就 是 将 HTML 文 
中 ， 根 据 这 个 思路 修改 上 面 代码 : 


档 写 


在 文件 中 ,在 使 用 的 时 候 加 载 到 变量 


2co | 
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1. 创建 一 个 templates/time.html x: 
创建 一 个 templates/time.html 文件 ， 如 图 19-1 所 示 。 
2， 修 改 视图 图 19-1 


def current datetime (request): 
now = datetime.datetime.now() 
context — ( 'time' : now ] 
rendered = render to string('time.html', context-context) 
return HttpResponse (rendered) 


3. 添加 URL 映射 

path(r'time/', views.current datetime, name-'time'), 

此 时 重启 服务 器 ， 访 问 current. datetime 视图 仍然 能 够 正常 显示 当前 时 间 。 

虽然 使 用 render to_string0 方法 已 经 实现 了 目的 ， 但 是 代码 仍然 不 够 简练 ， 如 果 项 目 中 
包含 很 多 视图 的 话 ， 就 需要 编写 很 多 遍 类 似 代码 : 

context = ( 'time' : now ) 


rendered - render to string('time.html', context-context) 
return HttpResponse (rendered) 


为 了 提高 开发 速度 、 减 少 代码 错误 ，Django 提供 了 一 些 快 捷 方 式 用 于 创建 Web response 
对 象 。 下 面 对 这 些 快 捷 方 式 进 行 详细 介绍 


19.3.2 render() 


作用 : 组 装 模 板 和 上 下 文 对 象 并 生成 HttpResponse 对 象 。 

语法 : render(request, template name, context-None, content type-None, status=None, using-None 

必 填 参数 如 下 。 

1. request 

Web request 对 象 ， 通 常 是 视图 方法 的 第 一 个 参数 

2. template_name 

一 个 或 多 个 模板 文件 名 ， 如 果 是 多 个 模板 文件 名 的 话 ，render0 方法 将 选择 第 一 个 可 以 
使 用 的 模板 进行 泻 染 。 

以 下 为 可 选 参数 。 

3. context 

个 字典 对 象 ， 字 典 中 的 元 素 值 可 以 填充 到 模板 中 。 
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4. content type 

生成 的 文档 MIME 2599, SEGA f) DEFAULT CONTENT TYPE 值 。 
5. status 

HTTP 状态 码 ， 默 认为 200。 


6. using 
用 于 加 载 模板 的 模板 引擎 名 。 
示例 : 


19.3.3 redirect() 


作用 : 返回 HttpResponseRedirect 对 象 用 以 进行 URL 跳 转 。 
请 法 : redirect(to, permanent-False, *args, **kwargs) 
参数 如 下 : 


1. to 

参数 to 可 以 是 以 下 一 种 类 型 : 

O 包含 get_absolute_url0 方法 的 模型 ; 
口 其 他 视图 名 ; 

QU 新 的 url 值 。 


2. permanent 
默认 为 非 永久 重 定向 ， 设 置 permanent-True 将 进行 永久 重 定向 。 
示例 : 
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19.3.4 get object or 404() 


TERI: 从 模型 中 提取 数据 ， 如 果 数 据 不 存在 则 抛 出 Http404 异常 。 
语法 : get object or 404(klass, *args, **kwargs) 

必 填 参数 如 下 。 

1. klass 


一 个 模型 类 、Manager 或 者 QuerySet 对 象 实例 。 


2. **kwargs 
查询 参数 ， 可 以 用 于 get) 或 者 filter) 方法 。 
示例 : 


以 上 示例 代码 等 价 于 : 


19.3.5 get_list_or_404() 


作用 : 使 用 filter0 方法 从 模型 中 提取 一 组 数据 ， 如 果 数据 不 存在 则 抛 出 Http404 异常 。 
语法 : get object or 404(klass, *args, **kwargs) 

必 填 参数 如 下 。 

1. klass 

一 个 模型 类 Manager 或 者 QuerySet 对 象 实例 。 

2. **kwargs 

查询 参数 ， 可 以 用 于 get) 或 者 filter() 方法 。 

示例 : 
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19.3.4 get object or 404() 


TERI: 从 模型 中 提取 数据 ， 如 果 数 据 不 存在 则 抛 出 Http404 异常 。 
语法 : get object or 404(klass, *args, **kwargs) 

必 填 参数 如 下 。 

1. klass 


一 个 模型 类 、Manager 或 者 QuerySet 对 象 实例 。 


2. **kwargs 
查询 参数 ， 可 以 用 于 get) 或 者 filter) 方法 。 
示例 : 


以 上 示例 代码 等 价 于 : 


19.3.5 get_list_or_404() 


作用 : 使 用 filter0 方法 从 模型 中 提取 一 组 数据 ， 如 果 数据 不 存在 则 抛 出 Http404 异常 。 
语法 : get object or 404(klass, *args, **kwargs) 

必 填 参数 如 下 。 

1. klass 

一 个 模型 类 Manager 或 者 QuerySet 对 象 实例 。 

2. **kwargs 

查询 参数 ， 可 以 用 于 get) 或 者 filter() 方法 。 

示例 : 
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以 上 示例 代码 等 价 于 : 


KEY 视图 装饰 党 


视图 装饰 器 是 一 系列 视图 方法 的 属性 ， 用 于 提供 对 HTTP 请 求 报 文 的 设置 。 


19.4.1 HTTP 方法 装饰 器 


HTTP 方法 装饰 器 用 于 约束 访问 视图 的 请 求 类 型 ， 该 装饰 器 位 于 django.views.decorators. 
http 模块 。 当 访问 视图 的 请 求 类 型 不 正确 时 ，HTTP 方 法 装饰 器 将 会 返回 django.http. 
HttpResponseNotAllowed 异常 错误 。 

代码 示例 : 


需要 注意 的 是 ，HTTP 请 求 类 型 必须 使 用 大 写字 母 。 

如 果 仅 允许 使 用 GET、POST 或 者 其 他 安全 类 型 (如 GET M HEAD 方法 ) 的 话 ， 可 以 使 
用 django.views.decorators.http 模块 下 面 的 其 他 装饰 器 : 

D require GET() 

D require POST() 

D require safe() 
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19.4.2. GZip 压缩 


GZip 是 目前 Internet. 上 非常 流行 的 数据 压缩 格式 ， 对 于 纯 文 本 文件 来 说 ，GZip 压缩 效 
果 非 常 明显 ， 大 约 可 以 压缩 文件 60% 至 70%。 当 用 户 访 问 网 页 时 ，Web 服务 器 使 用 GZip 算 
法 对 网 页 内 容 进行 压缩 ， 然 后 将 压缩 后 的 内 容 传 输 到 客户 端 浏览 器 。 由 于 需要 传递 的 字 节 数 
大 大 减少 ， 所 以 网 页 的 访问 速度 也 会 得 到 改善 。 

Django 中 的 GZip 视图 装饰 器 位 于 django.views.decorators.gzip 模块 。GZip 装饰 咒 还 会 
相应 地 设置 HTTP Vary 头 信息 。 


19.4.3 Vary 


Vary 是 一 个 HTTP 响应 头 部 信息 ， 它 决定 了 对 于 未 来 的 一 个 请 求 头 ， 应 该 用 一 个 组 
存 的 回复 (response) 还 是 向 源 服务 器 请 求 一 个 新 的 回复 。 它 被 服务 器 用 来 表明 在 content 
negotiationalgorithm (内 容 协商 算法 ) 中 选择 一 个 资源 代表 的 时 候 应 该 使 用 哪些 头 部 信息 
(headers) 一 一 来 自 mozilla.org- 

通俗 地 讲 ，Vary 决定 了 哪些 HTTP Header 会 被 用 来 检验 页 面 是 否 被 缓存 的 标准 。 例 如 
同一 个 网 址 分 别 为 桌面 浏览 器 和 移动 浏览 器 设置 了 不 同 内 容 ， 并 且 在 Vary 中 设置 了 User- 
Agent， 那 么 即使 用 户 使 用 移动 浏览 器 访问 过 网 页 并 生成 了 缓存 ， 但 是 如 果 此 时 用 户 改 用 桌面 
浏览 器 访问 网 页 时 ， 也 不 会 使 用 移动 端的 缓存 。 

Django 中 关于 Vary 可 用 的 装饰 器 包括 vary on cookie 和 vary_on headers. 

代码 示例 : 


将 cookie 设置 为 Vary: 


除了 直接 为 视图 添加 装饰 器 外 ， 还 可 以 使 用 patch_vary_headers() 方法 设置 HttpResponse 
对 象 ， 例 如 : 
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19.4.4 Caching 


Caching 装饰 器 位 于 django.views.decorators.cache 模块 ， 用 于 设置 服务 器 端 和 客户 端 


缓存 。 
1. cache control(**kwargs) 
设置 浏览 器 响应 的 Cache-Control 头 ， 可 选 参数 包括 以 下 几 种 ， 如 表 19-2 所 示 。 
表 19-2 
cache-directive 说 HH 
m 表示 任意 响应 内 容 都 可 能 被 缓存 到 任何 位 置 ， 这 些 响应 内 容 包括 本 来 不 应 该 缓存 的 内 容 或 
TN 者 应 该 被 缓存 在 私有 缓存 区 的 内 容 
de 表示 全 部 或 部 分 响应 内 容 都 会 被 当 作 单独 用 户 所 使 用 ， 并 且 只 缓存 到 私有 缓存 中 〈 仅 客户 
La 端 可 以 缓存 ， 代 理 服务 器 不 可 缓存 ) 
如 果 没 有 为 no-cache 提供 字段 ， 那 么 后 续 请 求 将 不 会 使 用 现 有 的 缓存 ， 后 续 请 求 必须 重新 
ea 进行 服务 区 验证 
如 果 为 no-cache 提供 了 一 个 或 多 个 字段 ， 那 么 后 续 请 求 将 会 使 用 现 有 的 缓存 ， 但 是 缓存 不 
包含 前 面 提供 的 字段 
a no-store 指令 可 以 防止 由 于 疏忽 而 发 布 或 保存 敏感 信息 ， 对 HTTP 请 求 或 响应 信息 有 效 。 
请 求 和 响应 都 禁止 被 缓存 
指示 客户 端 只 能 接受 有 效 期 小 于 指定 时 间 的 响应 ， 单 位 为 秒 (s)， 这 个 选项 只 在 HTTP 1.1 
IDaX-age 一 XXX 中 可 用 


代码 示例 : 
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2. never cache(view func) 
禁用 缓存 ， 使 用 never cache 装饰 器 将 会 为 视图 方法 添加 以 下 cache control: max- 
age=0, no-cache, no-store, must-revalidate- 


代码 示例 : 


使 用 浏览 器 调试 工具 查看 Response Headers， 如 图 19-2 所 示 。 


Y Response Headers view source 
Cache-Control: max-age-0, no-cache, no-store, must-revalidate 
Content-Length: 1814 
Content-Type: text/html; charset=utf-8 
Date: Mon, 25 Dec 2017 04:20:29 GMT 
Expires: Mon, 25 Dec 2017 04:20:29 GMT 
Server: WSGIServer/0.2 CPython/3.6.3 
X-Frame-Options: SAMEORIGIN 


19-2 


关于 更 多 cache-directive 介绍 可 参阅 RFC 2616: https://tools.ietf.org/html/rfc261 6Hsection-14.9 


ID Django 预 置 视图 


19.5.1 serve 


为 了 方便 开发 人 员 调试 代码 ，Django 预先 设置 了 一 个 serve 视图 。serve 视图 可 以 用 来 查 
看 任意 路 径 下 的 文件 ， 例 如 当 用 户 上 传 完成 后 ， 使 用 server 视图 查看 文件 是 否 保存 成 功 。 
Serve 视图 的 定义 如 下 : 
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使 用 serve 视图 时 可 以 直接 在 URLconf 中 调用 ， 例 如 : 


此 时 所 有 保存 在 MEDIA_ROOT 路 径 下 的 文件 都 可 以 直接 使 用 “ /media/ 文件 名 ”的 方 
式 进 行 访 问 。 


19.5.2 Error 视图 


异常 处 理 是 开发 人 员 一 直 需 要 进行 的 任务 ， 由 于 HTTP 异常 固定 就 是 几 种 ， 所 有 Django 
框架 中 对 这 些 异常 处 理 进行 了 封装 。 


1. HTTP 404 视图 

当 视 图 程序 抛 出 Http404 异常 时 ，Django 会 调用 一 个 视图 去 处 理 它 ， 默 认 时 ， 这 个 视 
图 是 django.views.defaults.page not found(). page not found() 会 在 网 页 中 输出 简单 的 “Not 
Found” 字 样 或 者 加 载 404.html。 

page not found() 视图 的 定义 如 下 : 


© defaults.page_not_found (request, exception, template name-'44.htm') 
使 用 page not found() 视图 时 需要 注意 以 下 几 点 : 
O 当 Django 无 法 找到 匹配 的 URL 时 也 会 抛 出 404 错误 。 
O HTTP 404 视图 可 以 接收 模板 上 下 文中 的 变量 。 
口 当 DEBUG 设置 为 True 时 HTTP 404 视图 将 被 禁用 。 


2. HTTP 500 视图 

当 Django 出 现 运 行 时 异常 时 会 调用 HTTP 500 视图 ， 默 认为 django.views.defaults. 
server error, server error 会 在 网 页 中 输出 简单 的 “ Server Error” 字 样 或 者 加 载 500.html。 注 
意 ，HTTP 500 视图 不 会 向 500.html 传递 任何 变量 ， 当 DEBUG 设置 为 True 时 HTTP 500 视 
图 将 被 禁用 。 
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server error 视图 的 定义 如 下 : 


defaults.server error(request, template name-'500.html') 


3. HTTP 403 视图 

对 于 HTTP 403 异常 ，Django 默认 的 视图 是 django.views.defaults.permission denied, i 
视图 会 在 网 页 中 输出 “403 Forbidden ”或 者 加 载 403.html。 

permission denied 视图 的 定义 如 下 : 


defaults.permission denied(request, exception, template name-'403.html') 


4. HTTP 400 视图 

当 出 现 SuspiciousOperation 异常 并 且 代 码 中 没有 进行 处 理 时 ，Django 会 发 生 “ bad 
request” Wo RUARI “bad request” 请 求 的 视图 是 django.views.defaults.bad request. 
bad request 视图 同样 要 求 DEBUG=False 


19.6 | HttpRequest 3| 


当 网 页 被 请 求 时 ，Django 会 自动 创建 一 个 HttpRequest 对 象 ， 这 个 对 象 包含 了 所 有 请 求 
中 的 必要 数据 。 每 一 个 Django 视图 都 会 在 第 一 个 参数 位 置 接收 HttpRequest 对 象 。 


19.6.1 属性 


除非 特殊 说 明 ， 所 有 的 HttpRequest 对 象 属性 都 是 只 读 的 ， 下 面 是 全 部 HttpRequest 对 象 


1. HttpRequest.scheme 

表示 请 求 所 用 网 络 协议 ， 通 常 是 http 或 者 https。 

2. HttpRequest.body 

HTTP 请 求 的 body 部 分 。 

3. HttpRequest.path 

请 求 资源 的 全 路 径 ， 例 如 “/music/bands/the_beatles/”。 


4. HttpRequest.path_info 
URL 中 主机 名 后 面 的 内 容 。 
如 http://127.0.0.1:8000/blog/ 的 path info 是 /blog/ ; http://127.0.0.1:8000/blog/1/ 的 path _ 
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info 是 /blog/1/。 


5. HttpRequest.method 
HTTP 请 求 所 使 用 的 方法 ， 属 性 值 必须 是 大 写 ， 如 GET. POST. 


6. HttpRequest.encoding 

用 于 处 理 表 单 提交 数据 的 编码 类 型 。HttpRequestencoding 是 可 编辑 属性 ， 当 请 求 所 提交 
的 数据 与 DEFAULT. CHARSET 不 一 致 时 ， 可 以 通过 修改 属性 值 的 方式 保证 能 够 正确 取得 请 
求 数据 。 


7. HttpRequest.content type 

表示 MIME 类 型 的 字符 串 。 

8. HttpRequest.content params 

表示 CONTENT TYPE 头 的 值 ， 格 式 为 字典 。 


例如 : <meta http-equiv="content-type" content="text/html;charset=utf-8"> 
9. HttpRequest.GET 

类 似 字典 类 型 的 对 象 ， 包含 所 有 HTTP GET 参数 。 

10. HttpRequest.POST 

类 似 字典 类 型 的 对 象 ， 包含 所 有 HTTP POST 参数 ， 通 常 是 表单 数据 。 
注意 POST 不 包含 文件 上 传 信息 。 


11. HttpRequest.COOKIES 
字典 对 象 ， 用 于 保存 所 有 cookie， 字 典 的 Key 和 Value 都 是 字符 串 。 


12. HttpRequest.FILES 
字典 对 象 ， 用 于 保存 所 有 被 上 传 的 文件 。 字 典 的 Key 是 HTML 元 素 <input type="file" 
name-"" /> 的 name， 字 典 的 值 是 UploadedFile 对 象 。 


13. HttpRequest. META 

字典 对 象 ， 包 含 所 有 HTTP 头 。 下 面 是 一 些 常用 的 Header: 

Q CONTENT LENGTH——Request body 的 长 度 。 

Q CONTENT_TYPE Request body MIME 类 型 。 

Q HTTP. ACCEPT——HTTP response 可 以 接收 的 文档 类 型 。 

Q HTTP. ACCEPT _ ENCODING 一 一 HTTP response 可 以 接收 的 文档 编码 类 型 。 
Q HTTP ACCEPT LANGUAGE——HTTP response 可 以 接收 的 文档 语言 。 
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ü HTTP HOST——X 户 端 发 送 的 HTTP Host header. 
口 HTTP USER_AGENT 一 一 客 户 端的 user-agent, 
Q QUERY STRING——URL 中 的 查询 字符 串 ， 通 常 是 “?” 后 面 的 部 分 。 


19.6.2 中间 件 属性 


一 些 Django 的 中 间 件 也 包含 HttpRequest 属性 ， 如 以 下 几 种 。 

1. HttpRequest.session 

SessionMiddleware 提供 的 用 于 存储 当前 session 信息 的 属性 ， 属 性 值 是 一 个 类 似 字 典 的 
对 象 ， 属 性 值 可 以 被 修改 。 


2. HttpRequest.site 
CurrentSiteMiddleware 提供 的 用 于 存储 当前 网 站 信息 的 属性 。 属 性 值 是 get_current_site() 
方法 返回 的 Site 或 者 RequestSite 对 象 。 


3. HttpRequest.user 

AuthenticationMiddleware 提供 的 用 于 存储 当前 用 户 的 属性 。 属 性 值 是 AUTH USER - 
MODEL 的 实例 对 象 。 如 果 当 前 没有 用 户 登 录 的 话 ， 属 性 值 是 AnonymousUser 对 象 。 

在 代码 中 可 以 使 用 is_authenticated 判断 用 户 是 否 登 录 ; 


if request.user.is authenticated: 


else: 


19.6.3 方法 


1. HttpRequest.get host() 
取得 HTTP X FORWARDED HOST fil HTTP HOST 的 值 。 如 果 这 两 个 Header 都 没有 
值 的 话 ，get_host(0) 方法 返回 SERVER NAME + SERVER PORT。 如 127.0.0.1:8000。 


2. HttpRequest.get_port() 
返回 网 站 端口 号 。 


3. HttpRequest.get full path() 
返回 URL 主机 名 后 面 的 全 部 信息 ， 例 如 /music/bands/the beatles/?print-true. 
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4. HttpRequest.build_absolute_uri(location) 

根据 localtion 返回 绝对 URI， 如 果 没 有 给 定 location 的 话 ， 默 认 会 使 用 HttpRequest.get_ 
full. path) 替代 location, 

下 面 在 Search 视图 中 调用 build absolute uri) 方法 : 


Search 视图 的 原始 URL 是 : http://localhost:8000/blog/1/。 


5. HttpRequest.get signed cookie(key, default=RAISE_ERROR, salt=", max age-None) 
返回 一 个 已 签名 的 cookie 的 值 ， 如 果 签 名 已 失效 则 抛 出 异常 。 

如 果 调 用 方法 时 指定 了 default 的 值 ， 那 么 默认 的 异常 信息 将 会 被 default 值 蔡 代 。 
调用 方法 时 给 出 了 salt 值 ， 可 以 有 效 地 防止 网 站 暴力 破解 攻击 。 例 如 : 


6. HttpRequestis secure() 
如 果 网 站 启用 了 HTTPS 协议 ，is_secure0 方法 返回 True， 和 否则 返回 False. 


7. HttpRequestis ajax() 
如 果 请 求 是 通过 XMLHttpRequest 对 象 发 送 的 ，is_ajax0 方法 返回 True， 和 否则 返回 Falses 


19.6.4 QueryDict 对 象 


前 面 多 次 提 到 “类 似 字典 的 对 象 "， 其 实 这 就 是 一 个 QueryDict 对 象 。QueryDict 与 普通 
字典 对 象 最 大 的 区 别 就 是 ，QueryDict 对 象 允 许 一 个 Key 对 应 多 个 Value。 
QueryDict 实现 了 字典 的 所 有 方法 ， 下 面 是 QueryDict 额外 提供 的 方法 。 


1. QueryDict. init (query_string=None, mutable=False, encoding=None) 
QueryDict 的 构造 方法 ， 例 如 : 
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2. QueryDict. getitem — (key) 
返回 指定 Key 的 值 ， 如 果 Key 包含 多 个 值 则 返回 最 后 一 个 值 。 如 果 Key 不 存在 的 话 ， 
抛 出 django.utils.datastructures.MultiValueDictKeyError 异常 。 


3. QueryDict. setitem — (Key, value) 
为 Key 赋值 ， 新 值 为 [value] (包含 一 个 元 素 的 列表 )。 


4. QueryDict. contains (key) 
对 于 判断 Key 是 否 存在 ， 由 于 这 个 方法 的 存在 使 得 判断 Key 更 加 简单 ， 例 如 : 


HttpResponse 对 象 


HttpResponse 对 象 是 对 用 户 访问 的 响应 ， 与 HttpRequest 对 象 不 同 的 是 ，HttpResponse 
对 象 需要 开发 人 员 在 视图 中 创建 。 

HttpResponse 对 象 属于 django.http 模块 。 可 以 直接 向 HttpResponse 对 象 中 传递 文本 、 选 
代 器 。 在 传递 文本 的 同时 可 以 指定 浏览 器 对 文本 的 处 理 方式 ， 例 如 : 


如 果 文 本 内 容 过 长 的 话 ， 还 可 以 像 文 件 对 象 一 样 ， 将 文本 分 批 写 信 ， 例 如 : 


另外 可 以 直接 操作 HttpResponse 的 Header 信息 ， 例 如 : 


注意 ， 不 像 字典 对 象 ， 如 果 删 除 一 个 不 存在 的 Key，del 方法 并 不 会 抛 出 异常 。 


19.7.1 属性 


1. HttpResponse.content 
HTTP 响应 的 内 容 。 


2. HttpResponse.charset 
HTTP 响应 所 使 用 的 编码 格式 。 
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3. HttpResponse.status_code 
HTTP 响应 的 状态 码 。 除 非 显 式 地 设置 了 HttpResponse.reason phrase, ®II) X} 
HttpResponse.status code 的 修改 也 会 改变 HttpResponse.reason phrase. 


4. HttpResponse.reason_phrase 
W3C 定义 的 Reason-Phrases, 


如 表 19-3 所 示 。 


500 


每 一 个 HITP 状态 码 都 对 应 一 个 Reason-Phrases 字符 串 ， 


表 19-3 
Reason-Phrases 
Continue 
OK 
Forbidden 
Not Found 


Internal Server Error 


关于 更 详细 的 HTTP Status Code +j Reason-Phrases fi E ii$ 4 W] https://urivalet.com/ 


reason-phrases o 


5. HttpResponse.streaming 
该 属性 值 永远 为 False。 由 于 
使 用 不 同 的 方式 来 处 理 流 响应 。 


6. HttpResponse.closed 
如 果 响 应 已 经 关闭 则 返回 True。 


19.7.2 方法 


HttpResponse.streaming 属性 的 存在 ，Django 中 间 件 才 可 以 


1. HttpResponse. init (content-", content type-None, status-200, reason-None, 


charset-None) 


fd: HR E RR CPV ER SC PS 


参数 说 明 : 


content: 字符 是 


BB 或 者 迭代 咒 。 


长 型 构造 HttpResponse 对 象 。 


content type: MIME 类 型 以 及 字符 集 ，content type 用 于 创建 Content-Type 头 。 
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status; HTTP 状态 码 。 
reason; HTTP Reason-Phrases. 
charset: 字符 集 。 


2. HttpResponse._ setitem_(header value) 
设置 HTTP 头 ，header 和 value 都 是 字符 串 。 


3. HttpResponse. delitem — (header) 
删除 指定 HTTP 头 ， 如 果 删 除 失败 不 会 抛 出 异常 。 区 分 字母 大 小 写 。 


4. HttpResponse. getitem — (header) 

返回 指定 HTTP 头 的 值 。 区 分 字母 大 小 写 。 

5. HttpResponse.has header(header) 

判断 HTTP 头 是 否 存在 ，header 区 分 字母 大 小 写 

6. HttpResponse.setdefault(header, value) 

如 果 指 定 的 HTTP 头 还 没有 设置 则 进行 设置 

7. HttpResponse.set cookie(key, value=", max age-None, expires-None, path="/", 
domainzNone, securezNone, httponly-False) 

设置 一 个 cookie。 

参数 说 明 ， 

max age: cookie 的 最 长 生命 周期 ， 单 位 为 秒 (s). UEN None, 此 时 cookie 的 生命 
周期 与 浏览 器 session 一 样 。 

Expires : cookie 的 过 期 时 间 ， 格式 为 "Wdy, DD-Mon-YY HH:MM:SS GMT" 或 者 UTC 
格式 的 datetime.datetime 对 象 。 

Domain: cookie 的 域 。 

httponly=True: 阻止 客户 端 JavaScript 访问 cookie。 

8. HttpResponse.set signed cookie(key, value, salt-", max age-None, 


expires-None, path="/", domain-None, secure-None, httponly-True) 
与 set cookie() 方法 相似 ， 不 过 set signed cookie() 方法 在 设置 cookie 之 前 会 进行 加 密 。 


9. HttpResponse.delete cookie(key, path='/', domain=None) 
删除 cookie。 删 除 失败 不 会 抛 出 异常 。 


9199 视图 


除了 以 上 方法 外 ，HttpResponse 对 象 还 可 以 像 文件 或 者 流 一 样 进行 读 写 操作 ， 具 体 方法 


如 下 : 


口 HttpResponse.write(content) 
口 HttpResponse.HushO 


O HttpResponse.tell() 


O HttpResponse.getvalue() 


O HttpResponse.readable() 


O HttpResponse.seekable() 


O HttpResponse.writable() 


O HttpResponse.writelines(lines) 


19.7.3 


HttpResponse F% 


为 了 处 理 不 同类 型 的 HTTP 响应 ，Django 还 提供 了 一 些 HttpResponse 子 类 。 


1. cl 


ass HttpResponseRedirect 


将 请 求 跳 转 到 其 他 地 址 。 对 应 的 HTTP 状态 码 是 302. 


2. c 


ass HttpResponsePermanentRedirect 


5j HttpResponseRedirect 相似 ， 进 行 页 面 跳 转 ， 不 过 HTTP 状态 码 是 301。 


3. c 


ass HttpResponseNotModified 


表示 从 用 户 最 后 一 次 访问 到 现在 ， 页 面 没 有 发 生 改 变 ，HTTP 状态 码 是 304. 


4. c 


ass HttpResponseBadRequest 


HTTP 状态 码 是 400。 


5. cl 


ass HttpResponseNotFound 


HTTP 状态 码 是 404。 


6. c 


ass HttpResponseForbidden 


HTTP 状态 码 是 403. 


T. c 


ass HttpResponseNotAllowed 


HTTP 状态 码 是 405。 构 造 函 数 的 第 一 个 参数 是 必需 的 ， 参 数值 是 一 组 任意 允许 的 HTTP 
method， 例 如 : l'GET', POST!]. 
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8. class HttpResponseGone 
HTTP 状态 码 是 401。 


9. class HttpResponseServerError 
HTTP 状态 码 是 500。 


Ir TemplateResponse 对 象 


由 于 HttpResponse 对 象 在 初始 化 结束 后 文档 内 容 就 已 经 固定 了 ， 很 难 再 进行 修改 ， 所 
以 在 使 用 中 可 能 会 遇 到 一 些 不 便 ， 例 如 修改 HttpResponse 对 象 所 使 用 的 模板 ， 或 者 在 现 有 
模板 中 添加 新 数据 ， 这 些 都 很 难 实现 。 为 了 解决 这 些 问题 ，Django 提供 了 一 个 全 新 的 对 象 : 
TemplateResponse。 与 HttpResponse 不 同 的 是 ，TemplateResponse 会 保留 模板 和 上 下 文 对 象 ， 
直到 需要 输出 时 才 将 模板 编译 成 HTML 文档 。 


19.8.1 SimpleTemplateResponse 对 象 


1. 属性 

SimpleTemplateResponse 是 TemplateResponse 的 基 类 ， 包 含 以 下 属性 ， 

( 1) SimpleTemplateResponse.template name 

SimpleTemplateResponse 对 象 所 使 用 的 模板 ， 可 接收 的 参数 包括 : 模板 对 象 (可 以 使 用 
get template() 方法 取得 )、 单 个 模板 名 、 一 组 模板 名 。 

例如 : ['foo.html', 'path/to/bar.html'] 

( 2) SimpleTemplateResponse.context data 

泻 染 模 板 时 所 使 用 的 上 下 文 对 象 ， 必 须 是 字典 类 型 。 

例如 : ('foo': 123) 

(3) SimpleTemplateResponse.rendered content 

使 用 当前 的 模板 以 及 上 下 文 对 象 所 泻 染 的 HTML 文档 内 容 。 

(4) SimpleTemplateResponse.is_rendered 

布尔 值 ， 表 示 当 前 HTML 文档 对 象 是 否 已 经 泻 染 完 所 

2. 方法 

SimpleTemplateResponse 对 象 包含 以 下 方法 : 


(1) SimpleTemplateResponse. init (template, context-None, content type-None, 


status-None, charset-None, using-None) 
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使 用 给 定 的 模板 、 上 下 文 对 象 、 文 档 类 型 、HITP 状 态 码 、 字 符 集 初始 化 
SimpleTemplateResponse 对 象 。 

参数 说 明 : 

Template; 可 以 是 模板 对 象 (可 以 使 用 get_template0 方法 取得 )、 单 个 模板 名 、 一 组 模板 名 。 

Context; 演 染 模板 时 所 使 用 的 上 下 文 对 象 ， 字典 类 型 。 默 认为 None。 

content type: 用 于 指定 HTTP Content-Type 头 的 MIME 类 型 和 字符 集 。 

Status: HTTP 状态 码 。 

Charset: 文档 所 使 用 的 字符 集 。 

Using: 模板 引擎 名 。 

( 2) SimpleTemplateResponse.resolve context(context) 

上 下 文 对 象 的 预 处 理 方 法 ， 接 收 一 个 字典 类 型 的 上 下 文 对 象 。 默 认 返 回 相同 的 字典 。 

(3 ) SimpleTemplateResponse.resolve template(template) 

将 模板 转换 为 模板 对 象 ， 方 法 可 以 接收 模板 对 象 (可 以 使 用 get. template( 方法 取得 )、 
单个 模板 名 、 一 组 模板 名 。 

( 4) SimpleTemplateResponse.add post render callback() 

为 模板 泻 染 程序 添加 回调 函数 。 通 过 回调 函数 可 以 有 效 地 推迟 默认 进程 的 执行 ， 如 使 用 
回调 函数 可 以 保证 只 有 模板 泻 染 结束 之 后 才 可 以 执行 缓存 程序 。 

当 SimpleTemplateResponse 对 象 泻 染 结束 ， 回 调 函 数 将 会 被 立即 执行 。 回 调 函 数 只 能 接 
收 一 个 SimpleTemplateResponse XJ 2 2 Zi 

如 果 回 调 函 数 返 回 值 不 是 None， 返 回 值 将 会 被 用 作 新 的 HttpResponse 对 象 。 

( 5) SimpleTemplateResponse.render() 

为 HTTP 响应 泻 染 HTML 文档 内 容 ， 如 果 文 档 已 经 被 泻 染 过 ，render0) 方法 将 不 执行 任 
何 操作 。 泻 染 后 的 HTML 文档 将 会 被 赋值 给 SimpleTemplateResponse.rendered content 对 象 。 


19.8.2 TemplateResponse 对 象 


TemplateResponse 对 象 的 构造 方法 定义 如 下 : 


TemplateResponse. init (request, template, context-None, content type-None, 
status-None, charset-None, using-None) 


参数 说 明 : 
Request: HttpRequest 对 象 实例 。 
Template: 可 以 是 模板 对 象 (可 以 使 用 get template) 方法 取得 )、 单 个 模板 名 、 一 组 模板 名 。 
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Context: 泻 染 模板 时 所 使 用 的 上 下 文 对 象 ， 字 典 类 型 。 默 认为 None。 
content type: 用 于 指定 HTTP Content-Type 头 的 MIME 类 型 和 字符 集 。 
Status: HTTP 状态 码 。 

Charset: 文档 所 使 用 的 字符 集 。 

Using: 模板 引擎 名 。 


19.8.3 TemplateResponse 对 象 泻 染 过 程 


TemplateResponse 对 象 实例 在 发 送 给 客户 浏览 器 之 前 必须 要 完成 泻 染 工作 。 有 以 下 三 种 
情形 TemplateResponse 对 象 会 被 演 染 : 

口 明确 调用 TemplateResponse.render() 方法 的 时 候 。 

Q 为 response.content 属性 赋值 的 时 候 。 

口 通过 template response 中 间 件 之 后 ， 但 是 还 没有 通过 response 中 间 件 。 

注意 TemplateResponse 对 象 只 能 够 被 泻 染 一 次 ， 当 演 染 完成 后 ， 继 续 调用 render) 方法 
将 不 起 任何 作用 。 但 是 如 果 重 新 为 response.content 赋值 的 话 ， 文 档 内 容 的 改变 还 是 会 被 应 用 
上 的 。 

下 面 是 几 种 这 染 TemplateResponse 对 象 的 方式 : 


19.8.4 回调 函数 


某 些 操作 必须 基于 一 个 完全 泻 染 结束 的 response 对 象 ， 如 缓存 操作 。 如 果 使 用 中 间 件 来 
处 理 这 些 操作 的 话 ， 一 切 都 能 正常 执行 ， 因 为 中 间 件 保证 了 所 有 操作 都 是 在 泻 染 结束 之 后 才 
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可 以 执行 ， 但 是 如 果 使 用 视图 装饰 器 的 话 就 会 出 问题 了 ， 因 为 装饰 器 是 被 立即 执行 的 。 为 了 
解决 这 些 问 题 ，TemplateResponse 允许 开发 人 员 注 册 回 调 函 数 ，TemplateResponse 的 回调 函 
数 是 在 模板 泻 染 结束 后 被 立即 执行 的 。 下 面 是 一 个 回调 函数 示例 代码 : 


19.8.5 ”使 用 TemplateResponse 对 象 


TemplateResponse 对 象 可 以 像 HttpResponse 对 象 一 样 使 用 ， 没 有 任何 限制 。 
下 面 修改 blog/index 视图 ， 使 用 HttpResponse 对 象 替代 HttpResponse: 


打开 浏览 器 查看 显示 效果 ， 如 图 19-3 所 示 。 
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文件 上 传 


文件 上 传 是 一 个 比较 普遍 的 网 站 功能 ， 在 服务 器 端 ， Django 会 使 用 一 个 叫 作 request. 
FILES 的 对 象 来 处 理 上 传 的 文件 。 本 节 主 要 介绍 Django 是 如 何 保存 文件 的 。 


19.9.1 一 般 文件 上 传 


编写 表单 类 ， 该 表单 包含 一 个 FileField 字段 。 


下 面 是 处 理 UploadFileForm 表单 的 视图 form_viewpy。 


创建 模板 文件 。 
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添加 URL 路 由 。 


代码 解析 : 

只 有 POST 请 求 方式 才 会 触发 文件 上 传动 作 。 

request.FILES 是 一 个 字典 对 象 ， 包 含 所 有 上 传 文件 ， 字 典 的 key 是 表单 类 的 字段 ， 本 例 
中 的 key jÈ “file” s 

用 于 文件 上 传 操 作 的 表单 元 素 需 要 包含 enctype="multipart/form-data" 属性 。 

为 了 避免 使 用 类 似 read0 方法 一 次 性 将 文件 读 取 到 内 存 中 造成 内 存 不 够 的 问题 ,使 用 
Échunks() 方式 将 文件 分 块 处 理 。 

文件 上 传 到 settings. MEDIA_ROOT 所 指定 路 径 下 的 upload 文件 夹 中 。 


19.9.2 ”多 文件 上 传 


由 于 标准 的 HTML 只 支持 使 用 <input type-"file"-, Ti <input type="file"> 每 次 只 能 上 传 
一 个 文件 ， 所 以 对 于 需要 进行 大 量 文 件 上 传 的 操作 来 说 会 很 不 方便 ， 这 在 Django 中 就 变 得 
相对 简单 很 多 。 

添加 FileFieldForm 表单 类 。 


添加 用 于 处 理 多 个 文件 上 传 的 表单 类 。 
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创建 模板 文件 multyupload.html.. 


添加 URL 路 由 。 


此 时 每 个 HTTP 请 求 都 可 以 上 传 多 个 文件 了 ， 浏 览 器 访问 效果 如 图 19-4 所 示 。 


€ > C [O 12700.1:5000/blog/multyupload/ 


File field [EEEE] 5 个 文件 [Submit] 
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AOU 类 视图 


除了 前 面 介绍 的 视图 方法 外 ，Django 还 提供 了 一 系列 类 视图 ， 如 通用 视图 。 通 过 使 用 类 
视图 可 以 提高 代码 重用 率 。Django 一 共 提 供 了 几 十 个 类 视图 ， 详 细 信 息 可 以 参考 Django 官 
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方 文档 : https://docs.djangoproject.com/en/2.0/ref/class-based-views/ . 
本 节 将 对 Django 的 类 视图 进行 简单 介绍 ， 并 选择 部 分 常用 视图 进行 讲解 。 


19.10.1 类 视图 入 门 


Django 提供 了 一 些 基 本 的 类 视图 ， 这 些 类 视图 能 够 直接 拿 来 使 用 ， 下 面 用 TemplateView 
来 演示 如 何 使 用 Django 的 类 视图 。 
修改 URL: 


浏览 器 访问 效果 如 图 19-5 所 示 。 


D) My amazing blog 


x 
€ > Q |O 12700.1:8000/blog/about/ LIH 


certior EIEN, 开发 人 员 可 以 直接 拿 来 使 


用 , 这 极 大 地 提高 了 代码 开 : 
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19.10.2 ”继承 类 视图 


如 果 Django 提供 的 类 视图 不 能 满足 工作 需要 的 话 ， 我 们 还 可 以 基于 已 有 的 类 视图 开发 
新 的 视图 。 
下 面 对 TemplateView 进行 重 写 : 


添加 URL: 
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此 时 重新 访问 http://127.0.0.1:8000/blog/about/， 显 示 效果 一 样 。 
开发 新 的 类 视图 的 好 处 就 是 ， 可 以 高 度 定制 化 类 视图 ， 如 修改 类 属性 、 修 改 数据 方 
法 等 。 


A 通用 视图 


19.11.1 通用 视图 概述 


很 多 情况 下 使 用 视图 来 显示 一 个 列表 或 者 一 个 对 象 的 详细 信息 。 正 是 由 于 类 似 的 工作 比 
较 常 见 ， 因 此 Django 提供 了 一 些 通用 类 视图 。 

下 面 仍然 以 Blog 应 用 程序 为 例 展示 如 何 使 用 通用 类 视图 。 

编写 视图 。 


修改 URL. 


创建 模板 。 

以 上 就 是 全 部 的 Python 代码 ， 下 面 添 加 模板 。 对 于 ListView, Django 会 自动 查找 名 为 
“模型 _list.html” 模 板 ， 本 例 中 默认 模板 名 为 “ blog_list.html”。 在 templates 文件 夹 下 创建 
“blog/blog list.html" : 
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注意 ， 由 于 ListView 是 通用 视图 ， 所 以 它 传递 给 模板 的 上 下 文 对 象 是 object. list 而 不 是 
具体 的 模型 名 。 
浏览 器 访问 效果 如 图 19-6 所 示 。 


19.11.2 ”修改 通用 视图 属性 


前 面 在 使 用 ListView 时 采用 的 是 默认 属性 ， 如 模板 名 和 上 下 文 对 象 ， 默 认 值 虽然 方便 但 
是 却 难以 理解 ， 下 面 我 们 就 试 着 修改 默认 值 : 


class BlogListView (ListView): 
model = Blog 
template name = 'blog_list.html' 
context_object_name = 'blogs' 


将 原 有 模板 名 重 命名 为 “blog _listhtml”， 上 下 文 对 象 修改 为 “blogs”。 在 浏览 器 中 重 
新 访问 效果 一 样 。 
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19.11.3 ”添加 额外 的 上 下 文 对 和 象 


有 时 我 们 在 模板 中 不 只 需要 默认 的 模型 数据 列表 ， 可 能 还 需要 额外 的 一 些 信息 ， 或 者 
我 们 需要 对 数据 列表 进行 一 定 的 修改 ， 此 时 可 以 通过 重 写 get_context_data() 方法 达到 这 样 
的 目的 。 

下 面 修改 代码 使 博客 列表 中 只 显示 最 近 发 布 的 三 篇 文章 ， 并 显示 全 部 作者 : 

修改 模板 : 


修改 视图 : 


浏览 器 访问 效果 如 图 19-7 所 示 。 
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quere ] 
€ > C |© 12700.:8000/blog/index/ x*|i 


* Lennon 


1 - 认识 Django 


2 - Django 版 本 选择 


8 - 搭建 Django 开发 环境 


图 19-7 


19.11.4 queryset 属性 


前 面 我 们 使 用 “ model = Blog” 在 通用 视图 中 指定 模型 ， 其 实 这 句 代码 是 queryset 的 简 
写 形式 ， 标 准 写 法 是 : 


queryset = Publisher.objects.all() 
通过 使 用 queryset 可 以 对 数据 进行 一 定 的 修改 ， 下 面 重新 编写 BlogListView: 


class BlogListView (ListView): 
queryset = Blog.objects.all()[:3] 
template name = 'blog list.html" 
context object name = 'blogs' 


def get context data(self, **kwargs): 
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此 时 网 页 将 只 显示 前 三 篇 博客 文章 。 


19.11.5 ”通用 视图 参数 
通用 视图 也 可 以 传递 参数 ， 下 面 的 URL 允许 接收 Author 作为 过 滤 条 件 。 


修改 BlogListView 视图 : 


修改 模板 : 
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浏览 器 显示 效果 如 图 19-8 所 示 。 


€ > Q |O 12700.1:8000/blog/index/Lennon/ 


* Lennon 


1 - iiRDjango 


19.11.6 ”通用 视图 与 模型 


从 上 面 示例 代码 不 难 发 现 ， 某 些 视图 指定 了 model 属性， 而 某 些 视图 并 没有 给 出 
model 属性 ， 但 是 所 有 这 些 视 图 都 能 够 很 好 地 工作 ， 这 是 由 于 通用 视图 可 以 从 以 下 三 个 方 
面 确定 模型 : 

口 视图 的 model 属性 指定 模型 。 

O 视图 的 get object() 方法 返回 模型 。 

O 视图 的 queryset 所 使 用 的 模型 。 


A 表单 视图 


Django 的 表单 视图 可 以 处 理 一 些 基本 的 表单 任务 ， 如 表单 验证 、 编 辑 等 。 以 前 面 的 
FileFieldView 视图 为 例 ， 如 果 当 用 户 没有 选择 任何 文件 时 就 单 击 提交 按钮 进行 提交 ， 表 单 会 
阻止 HTTP 请 求 并 弹出 提示 信息 ， 如 图 19-9 所 示 。 


DD 127.0.0.1:8000/blog/m x 
€ 3 C |O 12700.1:3000/blog/multyupload/ 


File field 选 泽 文 件 | 未 选择 任何 文件 ] [Submit] 
Hl mesne. 


图 19-9 


2s | BR 


3g] 300 Django 2.0 入 门 与 实践 


另外 当 用 户 提交 了 合法 信息 后 ， 还 可 以 使 用 form. valido 方法 执行 额外 操作 ， 下 面 修改 
FileFieldView 视图 ， 添 加 form valid() 方法 : 


重启 Web 服务 并 上 传 文件 ， 此 时 服务 器 输出 以 下 信息 : 


19.12.1 编辑 表单 视图 


通过 使 用 表单 视图 ， 可 以 在 编写 很 少 的 代码 的 情况 下 完成 模型 的 增删 改 操作 。 下 面 以 
Author 模型 为 例 看 看 如 何 使 用 表单 视图 编辑 模型 。 
修改 Author 模型 类 : 
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添加 视图 : 


添加 模板 : 
author form.html: 


author detail.html : 


author update.html : 
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author confirm delete.html : 


添加 URL: 


需要 注意 的 是 , UpdateView 和 DeleteView 对 于 POST 和 GET 请 求 都 有 不 同 的 处 理 方式 ， 
GET 请 求 只 会 用 于 显示 确认 信息 ， 而 POST 请 求 才 会 真正 执行 操作 ， 例 如 更 新 Author 时 首 
先 弹出 确认 框 ， 只 有 单 击 Update 按钮 之 后 才 会 真正 更 新 信息 ， 如 图 19-10 所 示 。 


t|: 
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Delete 操作 同样 需要 先进 行 确认 才 可 以 真正 执行 ， 如 图 19-11 所 示 。 


€ > Q [O 12700.1:8000/blog/author/5/delete/ t]: 


确定 要 删除 "admin" 吗 ?7 


图 19-11 


19.12.2 ”当前 用 户 


一 般 进行 数据 操作 时 都 需要 记录 执行 人 ， 也 就 是 当前 登录 的 用 户 ，Diango 使 用 User 模 
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块 进行 用 户 管理 ， 下 面 修改 Author 模型 使 其 能 够 记录 添加 Author 操作 的 用 户 信息 。 


修改 AuthorCreate 视图 : 


执行 migrations 命令 。 
重新 启动 Web 服务 并 登录 到 Admin( 目前 网 站 只 有 Admin 后台 登录 功能 )， 添 加 
Author。 
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在 前 面 章节 中 已 经 多 次 使 用 模板 ， 在 本 章 将 会 详细 介绍 Django 的 模板 。 模 板 可 以 看 作 
创建 HTML 页 面 的 样本 ， 模 板 包 含 静态 的 HTML 和 用 于 描述 如 何 动态 生成 HTML 的 特殊 语 
法 两 个 部 分 。 模 板 的 结构 和 HTML 文件 非常 相似 ， 甚 至 完全 可 以 使 用 一 个 HITML 文件 来 作 

Django 使 用 模板 引擎 对 模板 文件 进行 解释 ， 一 个 Django 工程 可 以 配置 一 个 或 者 多 个 模 
板 引擎 。 如 果 项 目 中 没有 使 用 模板 ， 那么 也 可 以 不 配置 模板 引擎 。Dijango 自 带 了 一 个 模板 系 
统 叫 作 Django Template Language (DTL)， 通 过 该 引擎 可 以 方便 地 加 载 模板 文件 并 在 内 存 中 
进行 编译 ， 然 后 插入 动态 数据 ， 最 后 返回 一 个 字符 串 。 

由 于 前 面 章节 已 经 详细 介绍 了 如 何在 Django 中 配置 模板 引擎 ， 因 此 这 里 就 不 再 袭 述 了 。 


BEI mii 


在 django.template.loader 模块 中 提供 了 两 个 方法 用 于 加 载 模板 : 

get template(template name, using-None) 

该 方法 接收 一 个 模板 名 ， 返 回 Template 对 象 。 

select template(template name list, using-None) 

该 方法 接收 一 个 模板 名 称 的 列表 ,返回 第 一 个 存在 的 Template 对 象 。 

当 找 不 到 对 应 的 模板 时 ， 这 两 个 方法 都 会 返回 TemplateDoesNotExist 异常 。 如 果 模 板 找 
到 了 ,但 是 模板 中 存在 语法 错误 ， 返回 TemplateSyntaxError 异常 。 

对 于 不 同 的 模板 引擎 ， Template 对 象 也 是 不 同 的 ， 但 是 Template 对 象 必须 包含 一 个 
render() 方法 。Render 的 语法 结构 如 下 : 

Template.render(context-None, request=None)。 


参数 说 明 : 
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O context 是 一 个 需要 被 展示 到 HTML 文件 上 的 数据 集合 ， 它 是 一 个 字典 对 象 。 如 果 
render 没有 接收 任何 context， 模 板 引擎 就 是 直接 泻 染 模板 而 不 插入 任何 数据 。 

O request 是 一 个 HttpRequest 对 象 。 不 同 的 模板 引擎 对 request 对 象 的 处 理 方式 不 同 。 

假设 存在 如 下 模板 配置 。 


下 面 是 get_template0 方法 的 模板 查找 顺序 : 

(1 ) /home/html/example.com/story detail.html ('django' engine) 

( 2) /home/html/default/story detail.html ('django' engine) 

( 3) /home/html/jinja2/story detail.html (jinja2' engine) 

下 面 是 select template(['story 253 detail.html', 'story detail.html']) 方法 的 模板 查找 顺序 : 

(1) /home/html/example.com/story 253 detail.html ('django' engine) 

( 2) /home/html/default/story 253 detail.html ('django' engine) 

(3) /home/html/jinja2/story 253 detail.html (jinja2' engine) 

( 4) /home/html/example.com/story detail.html ('django' engine) 

(5) /home/html/default/story detail.html ('django' engine) 

(6) /home/html/jinja2/story detail.html (jinja2' engine) 

—H Django 找到 了 匹配 的 模板 引擎 ， 查 询 工作 就 会 停止 ， 即 使 后 面 存在 其 他 匹配 的 模 
板 文 件 也 不 会 继续 查询 了 。 这 样 做 可 以 通过 子 文件 夹 将 不 同 应 用 程序 的 模板 文件 分 别管 理 ， 
使 整个 工程 结构 变 得 清晰 。 

如 果 使 用 文件 路 径 查 找 模板 的 话 ， 例 如 : 


对 于 同样 的 模板 配置 ， 将 会 在 下 面 的 路 径 进 行 查找 : 
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( 1) /home/html/example.com/news/story detail.html ('django' engine) 
( 2) /home/html/default/news/story detail.html ('django' engine) 
(3) /home/html/jinja2/news/story detail.html ('jinja2' engine) 


EE 模板 语音 


Django 的 模板 语言 非常 强大 ， 对 于 有 过 HTML 开发 经 验 的 人 来 说 会 感到 非常 亲切 。 本 
节 将 详细 介绍 Django 的 模板 语言 。 

Django 的 模板 是 一 个 简单 的 文本 文件 ， 可 以 是 任何 文本 格式 ， 如 HIML XML TXT 等 ， 
推荐 使 用 .HTML 格式 。 模 板 语言 主要 包括 变量 (variables) 和 标签 (tags) 两 部 分 。 变 量 在 模 
板 演 染 时 被 具体 的 值 所 蔡 代 ， 而 标签 则 用 于 处 理 代 码 逻 辑 。 


20.2.1 变量 


在 模板 中 变量 是 使 用 {{ 和 }} 包围 起 来 的 对 象 ， 它 的 值 存放 在 上 下 文 对 象 ( context) 中 ， 
context 中 可 能 存在 很 多 变量 ， 这 些 变量 按照 字典 (dict) 的 形式 保存 。 

变量 名 可 以 包括 字母 、 数 字 和 下 画 线 ， 但 是 绝对 不 可 以 包括 空格 和 其 他 标点 符号 ， 

英文 句点 〈.) 在 变量 中 有 特殊 意义 ， 如 果 模 板 引擎 遇 到 句点 将 会 按照 下 面 的 顺序 rut 
行 解释 : 

(1) 字典 查找 。 

(2) 查找 属性 和 方法 。 

(3) 查找 下 标 。 

注意 ， 如 果 句 点 后 面 的 变量 是 一 个 方法 ， 那 么 这 个 方法 会 按照 空 参数 的 方式 调用 ， 例 如 
一 个 字典 的 iteritems 方法 可 以 在 模板 中 用 以 下 方式 调用 。 


{% for k, v in defaultdict.items $%} 
Do something with k and v here... 
{% endfor 5$) 


20.2.2 ”过 滤器 


过 滤器 可 以 用 来 修改 变量 的 显示 样式 。 

过 滤器 的 使 用 方式 : {{ 变量 | 过 滤器 方法 }}。 过 滤器 可 以 连续 使 用 ， 形 式 如 : (( 变量 | 
过 滤器 方法 1| 过 滤器 方法 2}}。 
注意 变量 、 管 道 符 CD 和 过 滤器 方法 之 间 不 能 有 空格 。 
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某 些 过 滤器 还 可 以 接收 参数 ， 例 如 : {{ bioltruncatewords:30 }}， 这 句 代码 的 意思 是 显示 
bio 的 前 30 个 单词 。 

如 果 过 滤器 参数 包含 空格 的 话 ， 参 数 就 要 用 引号 包括 ， 例 如 : {{ listljoin:", " }}。 

Django 大 约 提供 了 60 个 过 滤器 ， 具 体 介 绍 可 以 参看 Django 官方 文档 : https://docs. 
djangoproject.com/en/2.0/ref/templates/builtins/Zref-templates-builtins-filters . 

下 面 介绍 几 种 常用 的 过 滤器 。 


1. add 

加 法 运算 : {{ valueladd:"2" 1). 

这 个 方法 会 先 按照 数值 来 计算 ， 如 果 失 败 了 就 直接 将 两 个 值 拼接 在 一 起 ， 如 连接 两 个 
数组 。 

如 果 value 是 4， 则 输出 6， 如果 value 是 “Django”， 则 输出 “Django2”、 如 果 value 是 
列表 ， 则 会 进行 列表 拼接 。 

2. capfirst 

首 字母 大 写 : ((value|capfist }}。 


3. center 
使 用 指定 宽度 将 值 居 中 显示 ， 例 如 : ((valuelcenter:"15" 33, WWR value Æ “Django”, 
Ws " Django 


4. cut 

删除 指定 值 ， 例 如 去 掉 字 符 串 中 的 空格 : {{ valuelcut:" " }}。 

如 果 value 是 “String with spaces”， 那 么 输出 “Stringwithspaces”。 

5. date 

格式 化 日 期 ， 例 如 (( valueldate:"D dM Y" }} ， 该 方法 参数 较 多 请 参考 Django 官网 。 

6. default 

如 果 变 量 是 false 或 者 空 ， 显 示 默 认 值 。 例 如 : {{ value|default"nothing" }} ， 如 果 value 
是 false， 那 么 在 页 面 上 显示 nothing» 


7. escape 
将 字符 串 进 行 HTML 转 意 ， 例 如 : 


(5 autoescape off %} 
{{ titlelescape }} 
[5$ endautoescape 5$] 
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如 果 value 是 “&ltDiango&gt "”， 则 输出 «Django. 

8. filesizeformat 

将 文件 大 小 按照 人 类 可 读 的 形式 显示 ， 例 如 一 个 文件 有 123456789 个 字 节 ， 那 么 使 用 
filesizeformat 将 会 显示 成 117.7 MB ， 语 法 形式 : {{ valueļfilesizeformat 3] 。 

9. Join 

拼接 多 个 元 素 ， 例 如 : {{ valueljoin:" //" }}。 


10. length 

显示 一 个 字符 串 或 者 数组 的 长 度 ， 例 如 : {{ valuellength }}。 
11. linenumbers 

在 文本 前 显示 编号 。 

例如 : {{ valuellinenumbers }}。 

如 果 value 是 : 


那么 输出 : 


12. truncatewords 
如 果 文 字 太 长 则 缩短 显示 内 容 ， 例 如 : (( valueltruncatewords:2 3), ， 如 果 此 时 value 是 
“Joel is a slug”， 则 输出 “Joel is...” < 


13. upper 
字母 转换 大 写 显 示 ， 例 如 : {{ valuelupper }}, 40 $ value Æ “Django”, W fij iH 
“DJANGO” > 


20.2.3 标签 


标签 的 用 法 类 似 于 {% tag %j}。 标 签 相对 于 变量 来 说 更 加 复杂 ， 标 签 可 以 用 于 输出 文本 、 
控制 代码 执行 逻辑 等 。 
有 些 标签 还 需要 有 开始 标记 和 结束 标记 ， 这 类 标签 的 格式 类 似 于 : (96 tag 96) .… tag 
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如 果 value 是 “&ltDiango&gt "”， 则 输出 «Django. 

8. filesizeformat 

将 文件 大 小 按照 人 类 可 读 的 形式 显示 ， 例 如 一 个 文件 有 123456789 个 字 节 ， 那 么 使 用 
filesizeformat 将 会 显示 成 117.7 MB ， 语 法 形式 : {{ valueļfilesizeformat 3] 。 

9. Join 

拼接 多 个 元 素 ， 例 如 : {{ valueljoin:" //" }}。 


10. length 

显示 一 个 字符 串 或 者 数组 的 长 度 ， 例 如 : {{ valuellength }}。 
11. linenumbers 

在 文本 前 显示 编号 。 

例如 : {{ valuellinenumbers }}。 

如 果 value 是 : 


那么 输出 : 


12. truncatewords 
如 果 文 字 太 长 则 缩短 显示 内 容 ， 例 如 : (( valueltruncatewords:2 3), ， 如 果 此 时 value 是 
“Joel is a slug”， 则 输出 “Joel is...” < 


13. upper 
字母 转换 大 写 显 示 ， 例 如 : {{ valuelupper }}, 40 $ value Æ “Django”, W fij iH 
“DJANGO” > 


20.2.3 标签 


标签 的 用 法 类 似 于 {% tag %j}。 标 签 相对 于 变量 来 说 更 加 复杂 ， 标 签 可 以 用 于 输出 文本 、 
控制 代码 执行 逻辑 等 。 
有 些 标签 还 需要 有 开始 标记 和 结束 标记 ， 这 类 标签 的 格式 类 似 于 : (96 tag 96) .… tag 
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contents ... {% endtag 96) . 

Django 大 约 内置 了 20 多 种 标签 ， 具 体 介绍 可 以 参看 Django 官方 文档 : https://docs. 
djangoproject.com/en/2.0/ref/templates/builtins/Zref-templates-builtins-tags . 

下 面 选择 部 分 常用 标签 进行 介绍 。 

1. block 

用 于 定义 一 个 模板 块 ， 这 个 模板 块 可 以 被 字幕 版 重 写 ，block 的 用 法 如 下 : 


在 模板 继承 部 分 将 会 对 block 标签 进行 详细 介绍 。 


2. comment 

模板 中 的 注释 ， 模 板 引擎 将 会 忽略 {% comment %} 和 {% endcomment 96) 之 间 的 任何 
代码 。 

comment 的 用 法 如 下 : 


3. cycle 


循环 提取 cycle 的 值 。 例 如 下 面 代码 : 


假设 some list 的 长 度 大 于 2， 那么 输出 的 第 一 个 <t> 标签 的 class 就 是 row1， 第 二 个 
<tr> 标签 的 class 就 是 row2， 第 三 个 <tr> 标签 的 class 重新 使 用 rowl 直到 循环 结束 。 


4. extends 
用 于 标记 当前 模板 继承 自 哪个 父 模板 。 
extends 标签 有 以 下 两 种 使 用 形式 : 


在 模板 继承 部 分 将 会 对 extends 标签 进行 详细 介绍 。 
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5. for 
循环 遍历 一 个 列表 。 
例如 下 面 代码 使 用 for 循环 生成 一 个 无 序列 表 : 


还 可 以 使 用 reversed 对 列表 进行 翻转 : 


使 用 for 循环 遍历 字典 : 


for 循环 提供 了 一 些 变量 ， 如 表 20-1 所 示 。 


表 20-1 

变 R 说 明 
forloop.counter 当前 循环 位 置 (以 数字 1 位 起 始 ) 
forloop.counter0 当前 循环 位 置 (以 数字 0 位 起 始 ) 
forloop.revcounter 反 向 循环 位 置 (列表 的 最 后 一 位 是 1， 列 表 第 一 位 是 n) 
forloop.revcounterü 反 向 循环 位 置 (列表 的 最 后 一 位 是 0， 列 表 第 一 位 是 n-1 ) 
forloop.first 如 果 是 当前 循环 的 第 一 位 ， 返 回 True 
forloop.last 如 果 是 当前 循环 的 最 后 一 位 ， 返 回 True 
forloop.parentloop 上 级 循环 


代码 示例 : 


$20: 模板 311 [LS 


浏览 器 显示 效果 如 图 20-1 所 示 。 
代码 示例 : 


浏览 器 显示 效果 如 图 20-2 所 示 。 


o 
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b: 
is 
pl 


图 20-2 


6. for... empty 
当 被 遍历 对 象 为 空 时 ， 显 示 empty 标签 内 容 ， 其 他 部 分 与 for 循环 一 致 。 
代码 示例 : 


T. if 
条 件 判断 标签 ， 当 判断 条 件 为 真 时 (存在 、 非 空 、 非 False 值 ) 输出 标签 内 容 。 与 
Python 一 样 ， 寺 标签 也 支持 elif 和 else 条 件 分 支 语 句 。 代 码 示例 : 


同样 ， 计 标签 还 支持 对 判断 条 件 进行 逻辑 运算 ， 逻 辑 运 算 符 包括 and, or, not: 
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注意 不 能 在 过 标 签 中 使 用 圆 括 号 对 判断 条 件 进 行 分 组 ， 如 以 下 代码 将 会 抛 出 “ Could not 
parse the remainder: '(False' from "(False' ”错误 : 


除了 逮 辑 运算 符 外 ， 让 标签 还 支持 以 下 运算 符 : 


代码 示例 : 


让 语句 还 可 以 使 用 过 滤器 ， 如 使 用 length 过 滤器 显示 长 度 大 于 等 于 100 个 字符 的 信息 : 


8. include 


加 载 其 他 模板 。 例 如 加 载 "foo/bar.html": 


如 果 新 模板 中 包含 变量 ，include 标签 还 可 以 传递 变量 值 ， 例 如 模板 “ name_snippet. 
html” 形 式 如 下 : 


可 以 使 用 include 在 引用 “name_snippet.html” 的 同时 传递 参数 : 


如 果 在 应 用 “ name_snippet.html” 的 时 候 只 需要 传递 一 个 变量 值 而 忽略 其 他 变量 ， 可 以 


& 
- 
o 
& 
3; 
" 
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9. load 
加 载 自 定义 模板 标签 。 例 如 加 载 注册 到 somelibrary 和 package.otherlibrary 的 全 部 标签: 


加 载 somelibrary 中 foo 和 bar 两 个 标签 : 


10. now 


显示 当前 日 期 时 间 。 例 如 : 


11. url 

动态 生成 url， 详 细 使 用 方法 可 参见 17.8 节 。 

12. with 

为 复杂 变量 创建 别名 ,尤其 是 使 用 句点 访问 多 级 变量 时 非常 方便 : 


20.2.4 人 性 化 语义 标签 


除了 上 述 功能 性 标签 外 ，Django 还 提供 了 很 多 辅助 性 标签 ， 这 些 标签 只 是 为 了 使 变量 输 
出 变 得 更 加 可 读 ， 下 面 对 这 些 标签 进行 简单 介绍 。 

首先 为 了 使 用 这 些 标签 ， 需要 在 INSTALLED_APPS 中 注册 “ django.contrib.humanize " , 
然后 在 模板 中 引用 humanize:{% load humanize %}。 

下 面 是 具体 标签 介绍 : 


1. apnumber 
将 数字 1 ~ 9 转换 为 英文 单词 ， 但 是 其 他 数字 不 转换 ， 如 数字 10 将 被 原样 输出 。 
示例 : 


如 果 当 前 工程 语言 是 中 文 的 话 ， 数 字 将 会 被 转换 为 对 应 的 汉字 ， 例 如 : 
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{{ 1lapnumber }} 
(t 21apnumber }} 
{{ 5lapnumber }} 


输出 : 


HI 


2. intcomma 
输出 以 逗号 分 隔 的 数字 ， 如 4500 输出 4,500, 4500.2 输出 4,5002. 


3. intword 

以 文字 形式 输出 数字 ， 如 1000000 输出 “1.0 million", 1200000 输出 “1,2 Million" . 

对 于 中 文系 统 ， 将 会 输出 对 应 的 中 文 ， 如 1200000 输出 “1.2 百 万 ”。 

4. naturalday 

将 当前 日 期 以 m 一 天 输出 为 today、yesterday 和 tomorrow， 而 中 文系 统 分 别 输出 
“今天 “昨天 ”和 “明天 


5. naturaltime 

对 于 日 期 时 间 格 式 ， 时 间 值 与 系统 当前 时 间 比 较 ， 然 后 输出 结果 。 如 当前 时 间 输 出 
"now", 29 秒 前 输出 “29 seconds ago”。 如 果 使 用 naturaltime 输出 今天 、 昨 天 、 明 天 的 话 ， 
就 会 变 成 “现在 ”“23 小 时 以 后 ”“1 日 zi à 


6. ordinal 
将 数字 转换 为 序数 ， 如 1 输出 “1st”; 2 输出 “2nd”; 3 输出 “3rd”。 注 意 此 时 中 文 与 
英文 的 输出 一 一 样 。 


20.2.5 ” 自 定义 标签 和 过 滤器 


虽然 Django 已 经 提供 了 很 丰富 的 模板 标签 和 过 滤器 ， 但 是 在 实际 工作 中 还 是 会 遇 到 特 
殊 需 求 是 已 有 标签 和 过 滤器 所 不 能 实现 的 ， 此 时 可 以 开发 自 定义 模板 标签 和 过 滤器 来 实现 特 
殊 需 求 。 

通常 都 会 把 自 定 义 标签 和 过 滤器 放 在 Django 应 用 程序 的 templatetags 文件 夹 中 ， 如 果 
应 用 程序 中 没有 templatetags 文件 夹 ， 那 么 可 以 手动 创建 一 个 ， 这 个 文件 夹 与 models.py, 
views.py 文件 平 级 ， 最 后 不 要 忘记 在 这 个 文件 里 面 放 一 个 __ init py 文件 。 对 于 手动 创建 的 
templatetags 文件 来， 必须 要 重新 启动 server 才能 生效 。 
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templatetags 中 的 文件 名 就 是 将 来 新 标签 或 过 滤器 的 名 字 ， 所 以 起 名 字 要 谨慎 ， 不 要 
和 其 他 应 用 的 标签 、 过 滤器 重 名 。 


例如 ， 下 面 是 为 应 用 程序 polls 添加 自 定义 标签 后 的 目录 结构 : 


此 时 可 以 在 模板 中 使 用 下 面 代码 加 载 标签 poll_extras: 


为 了 使 Python Bi t IX Jy Django 自 定义 标签 或 过 滤器 ， 每 个 模块 都 需要 注册 包含 
template.Library 的 实例 : 


1， 自 定义 过 滤器 

自 定 义 过 滤器 就 是 一 个 可 以 接收 一 个 或 者 两 个 参数 的 Python 方法 : 

Q 接收 的 变量 可 以 是 任意 类 型 ， 并 不 局 限于 字符 串 ; 

口 过 滤器 方法 的 参数 可 以 有 默认 值 。 

例如 过 滤器 foo:(( varlfoo:"bar" }} ， 它 接收 的 变量 是 var， 它 的 参数 是 bar。 

由 于 模板 语言 不 能 够 处 理 异 常 ， 所 以 在 过 滤器 方法 中 出 现 的 异常 都 会 成 为 服务 器 异常 ， 
因此 应 该 避免 在 过 滤器 方法 中 出 现 异 常情 况 。 

下 面 是 一 个 自 定义 过 滤器 的 代码 示例 : 


下 面 是 过 滤器 cut 的 使 用 : 
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对 于 大 多 数 过 滤器 来 说 并 不 接收 参数 ， 所 以 这 类 过 滤器 的 写法 类 似 于 : 


一 旦 编写 完 自 定义 过 滤器 方法 ， 需 要 使 用 Library 实例 对 其 进行 注册 否则 不 能 使 用 ， 注 
册 代 码 如 下 : 


Library.filter() 方法 接收 两 个 参数 : 

a 第 一 个 参数 是 过 滤器 的 名 字 ; 

口 第 二 个 参数 是 过 滤器 方法 签名 。 

除了 使 用 filter 方法 注册 过 滤器 外 ， 还 可 以 使 用 方法 属性 的 方式 ， 例 如 : 


注意 ， 如 果 省 略 name 参数 的 话 ，Django 默认 使 用 方法 过 滤器 方法 名 作为 过 滤器 名 字 。 
如 果 需 要 限制 过 滤器 接收 的 变量 只 能 是 字符 串 的 话 ， 可 以 使 用 stringfilter 方法 属性 ， 


此 时 即使 给 过 滤器 传递 数值 类 型 也 不 会 出 现 异 常 了 。 

2.， 自 定义 标签 

由 于 标签 可 以 做 更 多 的 事情 ， 所 以 开发 自 定义 标签 比 开 发 过 滤器 更 复杂 ， 幸 好 Django 
为 创建 自 定义 标签 提供 了 一 些 快捷 方式 ， 可 以 帮助 开发 人 员 快 速 开发 出 自 定义 标签 。 

其 中 simple tag0 是 其 中 最 简单 的 一 类 快捷 方式 : 
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© django.template.librampsimple tag 000 
很 多 标签 的 工作 就 是 接收 一 些 参数 并 进行 简单 运算 ， 最 后 返回 运算 结果 ， 对 于 这 种 类 型 
的 标签 可 以 使 用 simple tag 进行 开发。 
下 面 以 格式 化 输出 当前 日 期 为 例 ， 查 看 如 何 使 用 simple_tag: 


在 模板 中 应 用 : 


在 simple tag 自 定义 标签 中 还 可 以 使 用 模板 的 上 下 文 对 象 ， 例 如 : 


注意 此 时 自 定义 标签 方法 的 第 一 个 参数 必须 是 “ context”。 
另外 simple tag 还 可 以 接收 位 置 参数 和 关键 字 参 数 : 


EX] WAR 00 0 0 0 0 000— 


模板 继承 


前 面 讲解 了 Django 模板 的 基本 结构 与 语法 ， 本 节 进 一 步 讲 解 模 板 的 另 一 个 重要 使 用 方 
法 一 一 模板 继承 。 

Django 的 模板 就 像 编程 语言 中 的 类 一 样 是 可 以 继承 的 ， 通 过 合理 地 使 用 模板 继承 可 以 
减少 开发 工作 量 ， 提 高 代码 可 复 用 性 ， 进 而 提升 工作 效率 。 如 果 我 们 仔细 观察 一 下 就 会 发 
现 ， 绝 大 多 数 网 站 不 论 网 站 规模 有 多 大 ， 一 个 网 站 的 不 同 页 面 之 间 都 会 有 相同 的 部 分 ， 以 
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W3School 为 例 ， 可 以 看 到 ， 该 网 站 的 头 部 、 主 菜单 、 底 部 网 站 信息 在 任何 页 面 都 是 一 样 的 ， 
甚至 可 以 认为 左 侧 菜单 、 右 侧 广告 栏 以 及 中 间 主 窗 体 都 是 一 样 的 ， 只 是 填充 的 内 容 不 同 而 
已 ， 如 图 20-3 所 示 。 


图 20-3 


面 对 这 样 的 网 站 如 果 开 发 员 对 每 一 个 页 面 都 单独 开发 ， 那 么 工作 量 会 非常 大 ， 而 一 旦 需 
要 进行 页 面 重 构 的 话 就 会 非常 困难 ， 需 要 修改 所 有 页 面 。 面 对 此 类 问题 的 通用 做 法 就 是 将 页 
面 的 通用 部 分 提出 来 ， 进 行 单独 开发 ， 然 后 不 同 的 页 面 同时 继承 这 些 公共 部 分 ， 这 样 会 在 很 
大 程度 上 减少 维护 成 本 。 

Django 通过 把 网 页 中 每 一 个 通用 部 分 定义 在 block 中 的 方式 实现 了 代码 分 离 ， 下 面 是 
Blog 应 用 程序 所 使 用 的 base.html 模板 : 
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它 是 网 站 的 骨架 ， 在 这 个 模板 骨架 中 没有 定义 任何 代码 实现 ， 只 定义 了 页 面 结构 ， 该 页 
面包 括 一 个 菜单 栏 以 及 页 面 主体 。 

下 面 是 detail.html 模板 ， 用 于 显示 博客 的 详细 信息 ， 通 过 使 用 {% extends "base.html" %} 
继承 了 base html。 这 个 子 模板 实现 了 所 有 base.html 中 的 content， 当 用 户 访 问 子 模板 页 面 时 ， 
模板 引擎 将 使 用 子 模板 中 的 block 值 重 写 base.html: 


最 终生 成 的 HTML 文件 如 图 20-4 所 示 。 

在 这 里 细心 的 读者 可 能 会 发 现 ， 子 模板 中 并 没有 定义 (96 block sidebar %}...{% endblock 
%}， 但 是 在 最 后 生成 的 HTML 文件 里 面 却 包含 了 这 一 部 分 内 容 ， 这 就 是 模板 继承 的 优势 ， 
我 们 可 以 在 一 个 公共 的 地 方 专注 地 开发 公共 内 容 ， 具 体 实 现 部 分 专注 自己 的 业务 实现 。 

注意 ，Django 中 的 模板 虽然 可 以 无 限 继承 ,但 是 一 般 建议 3 层 即 可 : 

O Base.html 层 ， 这 里 定义 网 站 的 整体 骨架 。 

O 具体 模块 .html， 这 里 定义 具体 的 模块 ， 例 如 页 眉 、 页 脚 等 独立 内 容 。 

O 具体 网 页 .html， 这 里 是 真正 实现 具体 网 页 的 模板 ,会 重 写 具 体 模块 并 集成 base.html。 

Django 官网 给 出 了 一 些 最 佳 实践 ， 在 开发 自己 网 站 的 时 候 可 以 参考 : 
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O 在 base.html 中 尽 可 能 多 地 使 用 block。 
Q 如 果 发 现在 多 个 模板 中 都 重复 写 了 一 些 代 码 ， 那 么 可 以 考虑 将 这 些 代码 放 在 上 级 模板 
的 block 中 。 


DI View-source:127.00.1: x 


3 © |O view-source:127.0.0.1:8000/blog/1/ 
IDOCTYFE htal 


baee aid 


rom http-equiv-"Content-Type" content-'text/htnl; charset-gb2312" /> 
(neta http-equiv-"Content-Language" content=" zh-cn" /> 
(title amazing siteC/title? 
Clirk rel="stylesheet” type="text/css" href-'/static/css/myblog.css" /> 
/head> 


<body> 
<div id=" sidebar» 


<u> 
<li><a href=" /" )Homeć/a></1i> 
<li><a href=" /about/" »about SD 4/11» 
ur 


</div> 
<div id=" content» 
<div ani center> 
'lass="blog_head">1 ~ 认识 Djangoc/h2> 


<p iur blog body» 
jangof ME ESI hon 语 言 开发 的 一 套 重 鲁 锅 Web 框 架 ， 其 设计 的 初衷 就 是 为 了 帮助 开发 人 员 以 最 小 的 
Im UM 。Django 通 过 丰富 的 内 置 功能 使 开发 人 员 押 脱 了 很 多 以 往 ¥eb 开 发 中 的 困难 ， 进 而 得 以 将 更 多 
ui d 发 中 。 


T E T T T m 


EFESE] 


图 20-4 


如 果 想 在 子 模板 中 引用 父 模板 中 的 block， 可 以 使 用 {{ block.super }} 标签 。 例 如 在 上 面 
例子 中 ， 在 菜单 中 添加 更 多 的 菜单 ， 可 以 按照 下 面 代码 实现 : 


浏览 器 访问 ， 如 图 20-5 所 示 。 


图 20-5 


需要 注意 的 是 ， 在 一 个 模板 文件 中 block 的 名 字 是 唯一 的 不 能 重复 。 
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表单 是 Web 应 用 的 重要 组 成 部 分 ， 可 以 用 来 接收 用 户 输入 信息 ， 关 于 表单 的 详细 介绍 可 
以 参考 本 书 Web 编程 基础 的 表单 部 分 。 

Django 的 表单 系统 可 以 完成 绝 大 多 数 表单 工作 ,包括 显示 表单 内 容 、 编 辑 表 单 demas 
证 、 表 单 提交 等 ， 同 时 使 用 Django 表单 相对 于 大 多 数 开发 人 员 自 己 开发 来 说 会 更 安全 。 本 
节 将 详细 介绍 Django 的 表单 系统 。 


BKI Form 类 


Django 表单 系统 的 核心 是 Form 25, Form 类 用 于 描述 表单 并 决定 表单 如 何 工作 ，Form 
类 的 字段 对 应 HTML 元 素 ， 每 一 个 表单 字段 都 是 一 个 类 ， 这 些 字 段 用 于 管理 表单 数据 并 在 表 
单 提交 时 进行 数据 验证 。 
在 Django 模板 中 可 以 按照 标准 HTML 的 写法 创建 表单 ， 例 如 : 
«form action-"/your-name/" method="post"> 
<label for-"your name"»Your name: «/label» 
<input id-"your name" type="text" name-"your name" value-"(( current name }}"> 


«input type-"submit" value-"OK"» 
«/form» 


也 可 以 使 用 Form 类 创建 表单 ， 下 面 代码 是 form.py 内 容 用 于 泻 染 同样 的 HTML 表单 : 
from django import forms 


class NameForm(forms.Form): 
your name = forms.CharField(label-'Your name', max length-100) 


使 用 NameForm 生成 的 HTML 代码 如 下 (注意 在 这 里 并 没有 生成 «form» 元 素 ): 


<label for-"your _ name">Your name: «/label» 
«input id-"your name" type-"text" name-"your name" maxlength-"100" required /» 


创建 视图 用 于 处 理 表单 请 求 : 
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创建 模板 name.html : 


当 完 成 页 面 泻 染 时 ， 所 有 表单 内 容 都 会 车 换 到 {{ form }} 标签 。 
到 此 为 止 ， 一 个 最 简单 的 表单 就 完成 了 。 


表单 字段 类 型 


前 面 的 NameForm 类 只 有 一 个 字段 ， 字 段 类 型 是 CharField， 对 应 的 HIML 元 素 是 
<input type="text" ...>, 这 里 的 HTML 元 素 叫 作 字段 的 Widget。 除 此 之 外 ，Dijango 的 Form 类 
还 提供 了 几 十 种 字段 类 型 ， 每 种 类 型 分 别 对 应 不 同 的 HTML 元素 ， 下 面 对 这 些 类 型 进行 简 
单 介 绍 。 如 果 需 要 更 详细 的 表单 字段 介绍 ， 可 以 参考 Django 官网 : https://docs.djangoproject. 
com/en/2.0/ref/forms/fields/ 


1. BooleanField 
Widget: CheckboxInput(-input type="checkbox" ...7). 
空 值 : False。 
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标准 值 : True、False。 
验证 : 如 果 设 置 了 required=True， 则 验证 字段 值 是 否 为 True。 
验证 点 : required。 


2. CharField 
Widget: TextInput(-input type="text" ...7). 


2g 


A: empty value. 

标准 值 : 字符 串 。 

验证 : 如 果 设 置 了 max length, min_length， 则 验证 字段 长 度 是 否 符合 要 求 ， 否 则 不 验证 。 

验证 点 : required, max length, min length. 

3. ChoiceField 

Widget: Select(<select><option ...>...</select>) 

ZEE. ""。 

标准 值 : 字符 串 。 

验证 : 验证 字段 值 是 否 存在 。 

验证 点 : required, invalid choice. 

4. DateField 

Widget: DateInput(-input type="text" ...>), 

空 值 : None。 

标准 值 : Python datetime.date 对 象 。 

验证 : 验证 字段 值 是 否 是 正确 的 时 间 格 式 字符 串 、datetime.date 对 象 datetime.datetime 
对 象 。 

HES: required, invalid。 

5. DateTimeField 

Widget: DateInput(-input type="text" ...>), 

空 值 : None. 

标准 值 : Python datetime.datetime 对 象 。 

答 证 :验证 字段 值 是 否 是 正确 的 时 间 格 式 字符 串 、datetime.date 对 象 datetime.datetime 
对 象 。 


验证 点 : required, invalid。 
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6. DecimalField 

Wadget : 当 Field.localize-False 时 对 应 NumberlInput( <input type-"number" ...>), 否则 对 
应 TextInput(-input type="text" ...>)- 

空 值 : None。 

标准 值 : Python decimal X14 . 

验证 : 验证 字段 值 是 否 是 数值 类 型 。 


验证 点 : required, invalid, max value, min value, max digits, max decimal places, max - 


whole digits. 


7. FileField 

Widget: ClearableFileInput(-input type-"file" ...>), 
空 值 : None. 

标准 值 : 包含 文件 内 容 与 文件 名 的 UploadedFile 对 象 。 
验证 : 空 文件 或 者 没有 选择 文件 。 


验证 点 : required, invalid, missing, empty, max length 


8. FilePathField 
Widget: Select(-select»-option ...>...</select>)s 
空 值 : None。 
标准 值 :字符 串 。 
验证 : 选中 的 选项 是 否 存 在 于 下 拉 列 表 中 。 


验证 点 : required, invalid choice. 


9. ImageField 

Widget: ClearableFileInput(-input type-"file" ...7). 

空 值 : None. 

标准 值 : 包含 文件 内 容 与 文件 名 的 UploadedFile 对 象 。 

验证 : 空 文件 或 者 没有 选择 文件 。 

验证 点 : required, invalid, missing, empty, invalid image. 

10. IntegerField 

Widget : 当 Field.localize-False 时 对 应 NumberInput( <input type-"number" .. >)， 否 则 对 
应 TextInput(-input type="text" ...>)。 

空 值 : None。 
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标准 值 : Python integer X1. 
验证 字段 值 是 否 是 一 个 整数 。 


验证 点 : required, invalid, max value, min value. 


11. MultipleChoiceField 

Widget: SelectMultiple(-select multiple-"multiple"-...—/select»). 
空 值 : []( 空 列表 )。 

标准 值 : 一 组 字符 串 。 

验证 : 所 有 选中 值 存在 于 下 拉 列 表 中 。 


验证 点 : required, invalid choice, invalid list. 


BE 表单 字段 通用 属性 


1. required 


默认 情况 下 ， 所 有 的 表单 字段 都 是 必 填 字段 ， 这 样 如 果 提交 表单 时 没有 为 字段 赋值 ， 则 


会 抛 出 ValidationError 异常 。 
对 于 非 必 填 字段 可 以 设置 required-False 避免 验证 错误 ， 例 如 : 


forms.CharField (required=False) 


2. label 


为 表单 字段 指定 一 个 label 元 素 用 于 显示 字段 信息 ， 如 上 面 your_name 字段 将 会 额外 显 


示 一 个 label: 
<label for="your name">Your name: </label> 
3. initial 
为 字段 设置 初始 值 。 
4. help text 
为 字段 添加 帮助 性 文字 。 
5. error messages 
重 写字 段 的 默认 错误 提示 信息 error messages 是 一 个 字典 类 型 。 
例如 设置 当 CharField 的 “required ”验证 失败 时 显示 “请 输入 你 的 名 字 ” 


name = forms.CharField(error messages-('required': ' 请 输入 你 的 名 字 '}) 
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6. localize 


设置 表单 字段 是 否 启用 本 地 化 。 


7. disabled 
当 设 置 disabled=True 时 ， 使 用 HTML disabled 属性 禁用 字段 。 


BEJ 表单 与 模板 


在 模板 中 泻 染 表单 非常 简单 ， 只 需要 在 模板 中 添加 form 标签 即 可 : {{ form }}。 可 以 使 
用 以 下 方式 对 form 格式 进行 设置 : 

O {{ form.as_table }} 使 用 <t> 标签 显示 表单 字段 ， 注 意 表单 不 会 生成 <table> 标签 。 

Q (( formas p }} 使 用 «p» 标签 显示 表单 字段 。 

O (( form.as ul )) 使 用 <i> 标签 显示 表单 字段 ， 注 意 表单 不 会 生成 <ul> 标签 。 

除了 使 用 {{ form }} 自动 生成 表单 外 ， 还 可 以 手动 创建 表单 内 容 : 


其 中 hidden fields 是 表单 的 隐藏 字段 ，visible_ fields 是 表单 中 可 显示 字段 。 
如 果 不 需要 判断 表单 字段 是 否 显示 则 可 以 直接 遍历 form 对 象 ; 
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up 


通过 前 面 的 学 习 ， 读 者 应 该 能 够 独立 开发 Django 应 用 程序 了 ， 在 本 章 将 会 学 习 如 何 部 
署 Django 应 用 程序 。 


EEJ 坏 境 检查 


由 于 互联 网 是 一 个 开放 的 环境 ， 在 网 络 上 存在 各 种 各 样 的 危险 ， 所 以 在 将 Django 应 用 
程序 部 署 到 Web 服务 器 之 前 我 们 需要 检查 应 用 程序 的 配置 信息 ， 包 括 安全 、 性 能 以 及 其 他 选 
项 ， 保 证 Django 应 用 能 够 以 最 优 的 状态 在 互联 网 中 运行 。 

虽然 Django 自 带 了 很 多 安全 组 件 ， 但 是 并 不 是 所 有 组 件 都 默认 被 开启 了 ， 因 为 这 些 组 
件 会 为 开发 带 来 不 必要 的 麻烦 ， 例 如 并 不 是 所 有 网 站 都 需要 HTTPS， 那 么 在 开发 过 程 中 也 完 
全 没有 必要 启动 它 。 


22.1.1 网 络 攻击 与 保护 


Django 提供 了 对 多 种 网 络 攻击 的 防护 功能 ， 下 面 是 部 分 网 络 攻击 类 型 以 及 Django 对 应 
的 保护 方式 。 


1， 跨 站 脚本 攻击 

跨 站 脚本 攻击 ， 英 文 全 称 为 Cross Site Scripting (XSS)， 指 黑客 在 其 他 用 户 访问 的 网 页 
中 注入 恶意 代码 或 者 引诱 用 户 单 击 特定 的 网 络 连接 而 执行 攻击 脚本 ， 从 而 达到 攻击 目的 。 

默认 情况 下 Django 模板 会 将 每 一 个 输出 字符 进行 安全 转 义 ， 尤 其 是 以 下 5 个 字符 : 

口 将 < 转 义 为 &lt; 

口 将 > 转 义 为 &gt; 

口 将 ' (英文 单 引 号 ) 转 义 为 &#39; 

口 将 ” (英文 双 引 号 ) 转 义 为 &quot; 
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口 将 公转 义 为 &amp。 
因此 当 黑 客 在 网 页 中 注入 恶意 代码 时 ， 代 码 将 不 会 被 执行 。 例 如 注入 以 下 代码 : 


Django 模板 会 将 其 转 义 为 : 


但 是 并 不 是 所 有 特殊 字符 都 需要 转 义 ， 此 时 可 以 使 用 safe 过 滤器 将 字符 标记 为 安全 字 
符 。 例 如 当 变量 data 是 “<b>” 时 ， 以 下 两 种 写法 将 会 有 截然 不 同 的 输出 结果 : 


Safe 过 滤器 适用 于 单一 变量 的 转 义 ， 如 果 代码 段 包含 多 个 变量 需要 进行 安全 设置 时 ， 可 
以 使 用 autoescape 标签 ，autoescape 标签 接收 on 或 者 o 任 参数 ，on 表示 启用 模板 的 强制 转换 
功能 ，o 企 禁用 强制 转换 ， 以 下 是 autoescape 的 简单 应 用 : 


最 后 需要 注意 的 是 ， 由 于 Django 模板 的 变量 值 通常 是 从 数据 库 中 读 取 的 ， 因 此 在 保存 
数据 时 一 定 要 注意 数据 的 安全 ， 尤 其 是 保存 HTML 代码 。 


2.， 跨 站 请 求 伪造 攻击 

跨 站 请 求 伪造 攻击 ， 英 文 全 称 为 Cross Site Request Forgery ( CSRF)， 攻 击 者 会 在 用 户 不 
知情 的 情况 下 使 用 用 户 的 安全 证 书 进行 非法 攻击 。 例 如 当 用 户 登 录 完 网 银 后 ， 在 没有 退出 系 
统 的 情况 下 访问 了 攻击 者 的 恶意 网 站 ， 此 时 恶意 网 站 可 以 利用 用 户 已 有 的 session 系统 进行 非 
法 操作 。 

在 前 面 的 学 习 中 我 们 已 经 接触 了 Django 的 CSRF 保护 ，Django 的 CSRF 保护 可 以 保护 
我 们 免 受 绝 大 多 数 的 CSRF 攻击 。 在 使 用 Django 的 CSRF 保护 时 仍 存 在 一 些 限制 ， 如 开发 人 
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员 人 为 地 在 全 站 或 特定 视图 中 禁用 CSRF 保护 ， 或 者 网 站 存在 一 个 全 新 的 子 站 ， 主 站 与 子 站 


处 于 不 同 域 。 


Django 的 CSRF 保护 会 检查 每 一 个 POST 请 求 ， 这 使 得 攻击 者 不 能 通过 简单 的 提交 表单 
来 进行 非法 操作 。 


如 


果 使 用 HTTPS 协议 部 署 网 站 的 话 ，CsrfViewMiddleware 将 会 检查 每 一 个 HTTP 报 文 


头 以 确认 请 求 来 自 于 同一 个 域 。 


3. 


SQL 注入 


SQL 注入 是 攻击 者 在 网 站 数据 库 中 执行 一 段 恶意 SQL 脚本 的 攻击 方式 ， 这 类 攻击 通常 
会 导致 数据 库 被 删除 或 者 数据 泄露 。 

Django 的 queryset 能 够 有 效 地 阻止 SQL 注入 攻击 ， 由 于 SQL 脚本 中 的 参数 可 能 来 自 于 
用 户 提交 的 数据 ， 所 以 queryset 将 每 一 个 参数 都 进行 转 义 ， 这 样 保证 了 任何 被 执行 的 SQL 脚 


本 都 是 安全 可 靠 的 。 

由 于 Django 给 予 开发 人 员 很 大 的 自由 空间 ， 所 以 开发 人 员 仍 然 可 以 编写 自 定义 SQL 脚 
本 ， 对 于 这 种 情况 ， 开 发 人 员 一定 要 注意 代码 的 安全 性 。 

4. 单 击 劫持 


单 击 劫持 是 在 恶意 网 站 中 骨 入 一 个 iframe A 入 侵 的 网 络 
攻击 方式 ， 制 造 这 种 攻击 的 成 本 高 ， 非 常 少见 

Django 对 此 提供 了 保护 ， 利 用 中 间 件 XFrameOptionsMiddleware 可 以 有 效 地 阻止 自己 的 
网 站 被 其 他 网 站 以 frame 的 方式 引用 。 

如 果 网 站 不 需要 在 frame 中 引用 的 话 ， 强 烈 建议 启用 XFrameOptionsMiddleware。 

在 settings 中 引用 XFrameOptionsMiddleware: 


MIDDLEWARE = [ 


'django.middleware.clickjacking.XFrameOptionsMiddleware', 


22.1.2 ”检查 配置 信息 


| 


[以 使 用 manage.py check --deploy 命令 检查 当前 配置 信息 是 否 存 在 安全 隐患 。 


22-1 是 本 书 示例 代码 的 检查 结果 ， 从 输出 结果 可 见 ， 当 前 系统 存在 8 个 安全 隐患 。 
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图 22-1 


以 下 是 安全 检查 项 


1. SECRET. KEY 

SECRET KEY 必须 是 一 个 足够 长 的 随机 字符 串 , SECRET KEY 只 能 在 一 个 网 站 中 使 用 
绝对 不 能 泄露 

除了 直接 在 settings 中 设置 SECRET _ KEY 外 ， 还 可 以 在 环境 变量 中 加 载 它 : 


import os 
SECRET KEY = os.environ['SECRET KEY'] 


也 可 以 在 文件 中 加 载 它 : 
with open('/etc/secret key.txt') as f: 
SECRET KEY = f.read().strip() 

2. DEBUG 

DEBUG 配置 只 可 用 于 开发 环境 ,在 生产 环境 绝对 不 能 启用 ， 因 为 DEBUG 配置 将 会 
所 有 代码 跟踪 信息 显示 到 网 页 中 ， 这 些 信 息 包 含 很 多 敏感 内 容 如 数据 库 信息 等 。 

3. ALLOWED HOSTS 

设置 Django 应 用 的 主机 名 ， 只 有 访问 ALLOWED HOSTS 中 指定 主机 的 请 求 才 可 以 被 
Django 处 理 。 当 设置 DEBUG = False 时 ， 必 须 设 置 ALLOWED HOSTS, ®II) Django 不 允 
许 任何 请 求 访问 网 站 ， 这 个 配置 可 以 有 效 地 阻止 CSRF 攻击 。 


T 


4. CACHES 
如 果 Django 应 用 使 用 了 缓存 ， 那 么 开发 环境 与 生产 环境 通常 会 引用 不 同 的 缓存 地 址 ， 
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因此 在 部 署 Django 应 用 时 要 检查 缓存 地 址 是 否 正确 。 

5. DATABASES 

如 果 Django 应 用 使 用 了 数据 库 ， 那 么 开发 环境 与 生产 环境 通常 会 使 用 不 同 的 数据 库 ， 
因此 在 部 署 Django 应 用 时 要 检查 数据 库 配置 信息 是 否 正确 。 

6. EMAIL BACKEND 

如 果 系 统 使 用 了 邮件 功能 ， 那 么 需要 保证 在 部 署 到 生产 环境 时 使 用 正确 的 配置 ， 默 认 情 
WF, Django 使 用 webmaster@localhost 和 root(2localhost 发 送 邮 件 ， 如 果 和 希望 使 用 其 他 邮件 
地 址 的 话 ， 需 要 修改 DEFAULT_FROM EMAIL fil SERVER EMAIL. 


7. STATIC_ROOT 和 STATIC_URL 
在 开发 环境 系统 默认 使 用 开发 机 器 管理 静态 文件 ， 但 是 在 生产 环境 会 使 用 其 他 地 址 ， 因 
此 需要 重新 定义 collectstatic 能 够 访问 的 STATIC ROOT 路径。 


8. MEDIA ROOT 和 MEDIA URL 

由 于 媒体 文件 是 用 户 上 传 的 文件 ， RZE XERE, 一 定 要 保证 Django 系 
统 不 能 够 与 这 些 文件 进行 交互 ， 例 如 用 户 上 传 了 一 个 .py 文件 ， 这 个 文件 很 可 能 会 泄露 系统 
数据 或 破坏 系统 安全 。 


9. CSRF_COOKIE_SECURE 和 SESSION COOKIE SECURE 
在 生产 环境 需要 将 这 两 个 配置 设置 为 true 以 防止 人 为 地 通过 HTTP 传递 CSRF cookie 和 


session cookie. 


10. CONN MAX, AGE 

数据 库 连 接 的 生命 周期 ， 将 CONN MAX AGE 设置 为 0 时 ， 系 统 会 在 每 个 请 求 结束 后 
自动 关闭 连接 ， 如 果 设 置 为 None， 数据库 连接 将 成 为 一 个 持久 连接 ， 虽 然 这 样 会 提高 数据 
库 访 问 速度 但 是 会 持续 占有 数据 库 资 源 ， 需 要 根据 网 站 实际 情况 进行 设置 。 


E 使 用 Apache fil mod wsgi 31 Django 应 用 


WSGI 是 Web Server Gateway Interface 的 缩写 ， 用 于 描述 Web 服务 器 与 Web 应 用 程序 之 
间 如 何 通信 的 文档 ， 同 时 WSGI 规定 了 多 个 Web 应 用 程序 之 间 如 何 协调 工作 ， 是 Django 应 
用 的 最 主要 的 部 署 平台 。 通 过 使 用 startproject 命令 创建 Django 工程 的 时 候 会 自动 创建 一 个 
简单 的 WSGI 配置 文件 。 

Mod wsgi 是 Apache 的 一 个 模块 ， 可 以 用 于 部 署 任 何 Python WSGI 应 用 ,包括 Django。 
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Apache 支持 两 种 安装 mod wsgi 的 方式 : 

O 作为 传统 的 Apache 模块 直接 安装 在 现 有 的 Apache 中 ， 如 果 使 用 这 种 方式 安装 mod_ 
wsgi 的 话 ， 需 要 在 Apache 中 手动 配置 mod_wsgi 的 加 载 路 径 以 及 将 Web 请 求 指 向 
WSGI 应 用 程序 。 

口 使 用 pip 安装 mod_wsgi。 这 种 方式 将 会 直接 把 mod_wsgi 安装 在 Python 的 安装 路 径 ， 

安装 结束 后 会 启用 一 个 叫 作 mod_wsgi-express 的 应 用 ， 这 个 应 用 将 使 得 Apache 支持 

mod wsgi， 通 过 这 种 方式 安装 mod wsgi 可 以 免 去 任何 手动 配置 的 步骤 。 

以 上 两 种 安装 wsgi 的 方式 都 可 以 用 于 生产 环境 ， 而 第 ( 2 ) 种 方式 更 适用 于 Docter 


虽然 mod_wsgi 支持 所 有 最 新 的 Apache 版 本 ， 但 是 为 了 减少 配置 错误 ， 推 荐 使 用 
Apache 2.4. 


22.2.1 CentOS 上 安装 mod, wsgi 模块 


首先 执行 以 下 命令 检查 系统 中 是 否 已 经 安装 过 Apache: 
# rpm -qa httpd 
由 于 本 书 使 用 CentOS 7 作为 演示 平台 ， 系 统 默认 已 经 [root@localhost ~]# rpm -qa httpd 
httpd-2.4.6-67.el7.centos.6.x86 64 
安装 Apache， 因此 输出 结果 如 图 22-2 所 示 。 [rootélocalhost ~]# J 
执行 以 下 命令 检查 Apache 服务 状态 : H 22-2 


# service httpd status 
如 果 当 前 服务 不 可 用 则 输出 如 图 22-3 所 示 的 信息 。 


[rootelocalhost -]£ service httpd status 
Redirecting to /bin/systemctl status httpd.service 
e httpd.service - The Apache HTTP Server 

Loaded: loaded (/usr/lib/systemd/system/httpd.service; disabled; vendor prese 
t: disabled) 

Active: inactive (dead) 

Docs: man:httpd(8) 
man:apachectl(8) 


图 22-3 
如 果 当 前 服务 正在 运行 中 ， 则 输出 结果 如 图 22-4 所 示 。 
可 以 使 用 以 下 命令 启动 Apache 服务 : 
# service httpd start 


输出 结果 如 图 22-5。 
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[root@localhost ~]# service httpd status 
Redirecting to /bin/systemctl status httpd.service 
o httpd.service - The Apache HTTP Server 
Loaded: loaded (/usr/lib/systend/system/httpd.service; disabled; vendor prese 
t: disabled) 
Active: active (running) since Sat 2818-81-27 89:24:18 EST; 57s ago 
Docs: man:httpd(8) 
man:apachectl(8) 
Main PID: 2877 (httpd) 
Status: "Total requests: 10; Current requests/sec: 0; Current traffic: @ B/ 
sec" 
CGroup: /system.slice/httpd.service 
2877 /usr/sbin/httpd -DFOREGROUND 
2878 /usr/sbin/httpd -DFOREGROUND 
2879 /usr/sbin/httpd -DFOREGROUND 
2886 /usr/sbin/httpd -DFOREGROUND 
2881 /usr/sbin/httpd -DFOREGROUND 
2882 /usr/sbin/httpd -DFOREGROUND 
2883 /usr/sbin/httpd -DFOREGROUND 
2895 /usr/sbin/httpd -DFOREGROUND 
2896 /usr/sbin/httpd -DFOREGROUND 
2897 /usr/sbin/httpd -DFOREGROUND 


Jan 27 09:24:09 localhost.localdonain systend[1]: Starting The Apache HTTP Se... 
Jan 27 09:24:10 localhost.localdonain httpd[2877]: AH60558: httpd: Could not ... 


Jan 27 09:24:10 localhost.localdomain systend[1]: Started The Apache HTTP Ser... 
Hint: Some lines were ellipsized, use -l to show in full. 


图 22-4 


[rootelocalhost -]£ service httpd start 
Redirecting to /bin/systemctl start httpd.service 


图 22-5 


此 时 在 浏览 器 中 访问 localhost， 显 示 结 果 如 图 22-6 所 示 。 


Apache HTTP Server Test Page powered by CentOS - Mozilla Firefox coh dc 
apaehe HTTP Server Tes X \+ 


(€) © liocanost 1e ][& seas. ^"*B5$445» 


22-6 


如 果 操 作 系统 没有 安装 Apache 或 者 安装 的 Apache 版 本 太 低 ， 可 以 参考 Apache 官网 安 
装 或 升级 Apache， 官 网 地 址 : http://httpd.apache.org/docs/2.4/install.html。 
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安装 Apache 之 前 ， 先 安装 依赖 组 件 。 
1. 安装 apr 


2. 安装 apr-util 


可 用 在 以 下 网 址 查看 可 用 的 apr FI apr-util 版 本 : http://apache.fayea.com/apr/。 
3， 安 装 pcre 


4.， 完 成 准备 工作 后 安装 Apache 


5. 将 Apache 添加 到 环境 变量 


准备 好 Apache 服务 之 后 ， 下 面 开始 安装 mod_wsgi。 
首先 在 Python 官网 下 载 最 新 的 mod_wsgi 安装 包 : https://pypi.python.org/pypi/mod wsgi- 
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| 如 果 在 安装 mod_wsgi 时 出 现 无 法 加 载 libpythonX.Ym.so.1.0 的 错误 ， 请 检查 
| Python 的 安装 方式 ,正确 的 Python 配置 如 下 (其 中 CFLAGS=-fPIC 是 必 填 项 ): 


安装 结束 ， 打 开 httpd.conf 添加 以 下 内 容 : 


保存 退出 ， 接 下 来 编辑 1d.so.conf 文件 ， 将 Python 安装 路 径 添 加 到 配置 中 : 


重新 激活 Id.so.conf 文件 : 


此 时 Apache 服务 应 该 已 经 安装 成 功 ， 重 启 服务 即 可 。 如 果 重 启 过 程 中 出 现 无 法 找到 
libpythonX.Y.so.1.0 的 错误 ， 可 以 尝试 将 这 个 文件 从 Python 安装 目录 复制 到 /usr/local/lib 并 添 
加 软 连接 : 


此 时 在 浏览 器 中 访问 localhost 应 显示 如 图 22-7 所 示 的 页 面 。 


It works! 


22-7 
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22.2.2 Windows 上 安装 mod, wsgi 模块 


由 于 Apache 官方 只 提供 源 代码 并 不 提供 编译 后 的 安装 程序 ， 所 以 需要 下 载 源 代码 进 
行 编译 安装 ， 然 而 很 多 情况 下 用 户 可 能 不 具有 编译 Apache 源 代码 的 条 件 ， 此 时 可 以 选择 
Apache 贡献 者 提供 的 编译 后 的 安装 包 。 打 开 Apache 官网 ， 找 到 “Downloading Apache for 
Windows” 节 点， 下 面 列举 了 一 些 著名 的 Apache 编译 版 本 ， 本 书 选择 ApacheHaus 进行 安 
装 ， 如 图 22-8 所 示 。 


o Downloading Apache for Windows 


The Apache HTTP Server Project itself does not provide binary releases of software, only source code. 
Individual committers may provide binary packages as a convenience, but itis not a release deliverable 


It you cannot compile the Apache HTTP Server yourself, you can obtain a binary package from numerous 
binary distributions available on the Intemet. 


Popular options for deploying Apache httpd, and, optionally, PHP and MySQL, on Microsoft Windows, 
include 


[HEEMHEE — — 
|+ Apache Lounge 
» BitNami WAMP Stack 


" 


[e 
| XAMPP 


图 22-8 
Apache 官网 地 址 : http://httpd.apache.org/docs/2.4/platform/windows.html。 
单 击 打开 ApacheHaus 后 ， 网 页 上 列举 了 可 用 的 Apache 安装 文件 ， 读 者 需要 根据 个 人 操 
作 系 统 选 择 合适 的 版 本 ， 如 图 22-9 所 示 。 


Apache 2.4 Server Binaries 


Apache 2.4.x OpenSSL 1.0.2 VC14 

Built using C sources from the ASF and OpenSSL on Visual Studio 2015 (VC14) 
Note: VC14 binaries do not run on Windows XP or Server 2003 

See reaóme, frst hti fle for detals 


Apache 2.4.29 httpd-2.4.29-0102n-x86-vc14- 8,7648 KB Download Locations 
Qzp 

with OpenSSL 10 2n, broti 1.0.1, nghttp 1.27 0, ZIb 13888 em 

1.2.10, PCRE 8.41, APR 1.8.3, APR-ULI 16.1, IPV6 

enabled SHAT Checksum: 79c1a6320c1cfc11451b88371dfc30f61ccc18cb. 

Apache 24.29 x64 htpG.2429-0102n64Ac14- 9,9510KB Download Locatons 
nzo 

with OpenSSL 1.0.2n, brotii 1.0.1, nghttp 1.27.0, Zlib 20068 e m 

12.10, PCRE 841, APR 1.63, APR.UBI 1.6.1, IPV6 

enabled. SHA1 Checksum: 1337ec34a021ca63afe53154766cf32baded7995. 

图 22-9 


ApacheHaus 的 命名 规则 : 压缩 文件 名 字 中 带 有 x86 表示 适用 于 32 位 操作 系统 ， 例 如 
httpd-2.4.29-0102n-x86-vc14-r2.zip ; 压缩 文件 名 字 中 带 有 x64 表示 适用 于 64 位 操作 系统 ， 例 
如 httpd-2.4.29-0102n-x64-vcl4-r2.zip. 

注意 Apache 2.4 是 使 用 VC14 编译 的 。 
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选择 好 安装 文件 后 ， 单 击 谨 图标 进行 下 载 。 下 载 结束 后 将 zip 包 解 压 ， 本 书 以 解压 到 C 
盘 根 目录 为 例 ， 解 压 路 径 C:\httpd-2.4.29\Apache24， 解 压 后 的 目录 结构 如 图 22-10 所 示 


的 


称 


Ji bin 
cgi-bin 
conf 
Ji error 
htdocs 
icons 
include 
lib 
logs 
Ji modules 
国 ABOUT_APACHE. bt 
] CHANGES.txt 
INSTALL it 
LICENSE.txt 
] NOTICE.txt 
OPENSSL-NEWS.txt 
] OPENSSL-README.b«t 2 
是 README.txt 2014/1/24 0: 


图 22-10 


其 中 ，conf 文件 夹 是 Apache 的 配置 目录 

为 了 更 好 地 管理 Apache， 我 们 需要 将 它 安 装 成 Windows 服务 。 用 管理 员 身份 打开 命令 
行 窗口 ， 跳 转 到 Apache 的 bin 目录 。 输 入 以 下 命令 创建 一 个 名 为 Apache 的 Windows 服务 
( 见 图 22-11 ): 


> httpd.exe -k install -n "MyServiceName" 


图 22-11 


命令 执行 结束 ， 从 输出 信息 可 以 判断 Apache 安装 成 功 但 是 服务 没有 正常 启动 ， 失 败 


的 原因 是 Apache 服务 无 法 找到 正确 的 安装 目录 。 打 开 conf/httpd.conf 3c f/F, FR fl] Define 
SRVROOT "/Apache24", 1f /Apache24 替换 为 Apache 程序 存放 路 径 ， 本 例 为 C:\httpd-2.4.29\ 
Apache24， 修 改 后 的 配置 信息 为 “Deftine SRVROOT "C:httpd-2.4.29'Apache24" " -7 
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下 面 是 其 他 常用 命令 。 


启动 Apache 服务 : 


httpd.exe -k start -n "服务 名 " 

停止 Apache 服务 : 

httpd.exe -k stop -n "服务 名 " 

或 者 : 

httpd.exe -k shutdown -n "服务 名 " 

重启 Apache 服务 : 

httpd.exe -k restart -n "服务 名 " 

Apache 服务 安装 成 功 后 ， 安 装 mod wsgi. TE Windows 系统 中 安装 mod wsgi 前 需要 完 
成 以 下 准备 工作 : 

Q 添加 环境 变量 : MOD WSGI APACHE ROOTDIR， 变 量 值 对 应 Apache 安装 目录 ， 

本 例 使 用 C:/httpd-2.4.29/Apache24， 注 意 路 径 中 一 律 使 用 /， 路 径 结 尾 不 能 包含 / 
O 安装 最 新 版 .NET Framework 
O 安装 最 新 Microsoft Visual C++ 编译 程序 ， 编 译 程序 下 载 地 址 : http://landinghub. 


visualstudio.com/visual-cpp-build-tools 


准备 工作 完成 之 后 ， 打 开 命 令 行 提示 符 ， 执 行 以 下 命令 安装 mod_wsgi ( 见 图 22-12 ): 


> pip install mod wsgi 


Bi ERR 命 信 提 未 符 — Eram] 


安装 完 mod_wsgi， 执 行 以 下 命令 查看 mod_wsgi 配置 信息 ( 见 图 22-13 ): 


> mod wsgi-express module-config 
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如 果 安 装 过 程 中 出 现 无 法 找到 文件 的 错误 ， 这 可 能 是 由 于 Apache 第 三 方 贡献 者 所 提 
供 的 安装 包 不 完整 ， 解 决 办 法 是 到 GitHub 下 载 对 应 的 文件 ，GitHub 地 址 : https://github. 
com/traviscross/apro 

以 丢失 apr perms seth 文件 为 例 ， 打 开 GitHub include X fF 3, 4X f| apr perms set. 
h 文件 并 单 击 打开 。 在 apr perms set.h 文件 详细 页 ， 单 击 Raw 按钮 以 文本 文件 形式 查看 源 
代码 ， 复 制 文件 内 容 到 记事 本 ,将 新 文件 以 Unicode 格式 保存 到 CAhttpd-2.4.29:A pache24 


include, 


打开 C: Whttpd-2.4.29 Apache24 conf httpd.conf 配置 文件 ， 找 到 LoadModule 部 分 ， 将 全 部 
输出 信息 追加 到 LoadModule 结尾 
完成 以 上 操作 后 ， 重 启 Apache 服务 


22.2.8 ”配置 mod_wsgi 


对 于 初次 使 用 WSGI 部 署 网 站 的 人 来 说 ,不 建议 直接 部 署 复杂 的 网 站 ,例如 使 用 了 
Django 或 者 Flask 框架 的 网 站 ， 可 以 先 尝试 部 署 一 个 Hello World 程序 以 检查 mod_wsgi 是 否 
能 够 正常 工作 。 


下 面 是 一 个 简单 的 WSGI 应 用 程序 ,访问 后 将 会 在 网 页 中 输出 Hello World!， 用 于 检查 


mod_wsgi 是 否 安装 成 功 : 
import sys 
def application(environ, start response): 
status — '200 OK' 


output = b'Hello World!" 


response headers = [('Content-type', 'text/plain'), 
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将 以 上 代码 保存 为 hello.wsgi。 


i 默认 情况 下 ，mod_wsgi 要 求 WSGI 应 用 程序 的 入 口 必须 是 application， 如 果 需 要 使 | 
; 用 其 他 名 称 作为 应 用 程序 入 口 的 话 ， 需 要 修改 mod_wsgi。 

1. 在 CentOS 上 执行 hello.wsgi 

首先 打开 http.conf， 根 据 Apache 安装 情况 修改 以 下 配置 项 : 

口 ServerRoot "/usr/local/httpd" 

口 Listen 80 

口 ServerName localhost 

口 DocumentRoot "/usr/local/httpd/htdocs" 

将 hello.wsgi 文 件 复制 到 /usr/localhttpd/htdocs。 在 http.conf 根 节点 添加 WSGI 别名 : 
WSGIScriptAlias / $ {SRVROOT}/htdocs/hello.wsgis 

此 时 已 经 完成 全 部 Apache 配置 ， 重 启 服务 ， 打 开 浏 览 器 访问 http://localhost/hello.wsgi。 

显示 效果 如 图 22-14 所 示 。 


Coras — — — -ic]» B 


Hello World! 


22-14 


2. 在 Windows 上 执行 hello.wsgi 
首先 打开 http.conf， 根 据 Apache 安装 情况 修改 以 下 配置 项 : 
ü Define SRVROOT "C:\httpd-2.4.29\Apache24" 
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O Listen 8000 

OQ ServerName localhost 

ü DocumentRoot "$ ([SRVROOT /htdocs" 

将 hello.wsgi 文 件 复制 到 $S{SRVROOT}/htdocs， 本 书 的 ${SRVROOT}/htdocs 路 径 为 
C:httpd-2.4.29\Apache24\htdocs。 

在 http.conf 根 节 点 添加 WSGI 别名 : 
slscriptalias / S(SEVROOT)/htdocs/hellowegk 0 

此 时 已 经 完成 全 部 Apache 配置 ， 重 启 服务 ， 打 开 浏览 器 访问 http://localhost:8000/hello. 


wsgis 


显示 效果 如 图 22-15 所 示 。 
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附录 
ISO 


639-1 语言 代码 


i 言 ISO Code 语 ISO Code 
Abkhazian ab Croatian 
Afar aa Czech 
Afrikaans af da 
Amharic am nl 
Arabic ar Edo 
Armenian hy en 
Assamese as eo 
Azerbaijani az fo 
Bashkir ba fa 
Bengali (Bangla) bn fi 
Bhutani dz 
Bihari bh French 
Bislama bi Frisian 
Breton br Fulfulde 
Bulgarian bg gl 
Byelorussian (Belarusian) be Gaelic (Manx) gv 
Cambodian km Georgian 
Catalan ca German 
Cherokee el 
Chinese (Simplified) zh Guarani gn 
Chinese (Traditional) zh Gujarati 
Corsican co Hausa 
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iB 5 ISO Code 语 o8 ISO Code 
Hawaiian Malayalam ml 
Hebrew he, iw Maltese mt 
Hindi Maori mi 
Hungarian Marathi mr 
Tbibio Moldavian mo 
Icelandic is Mongolian mn 
Igbo Nauru na 
Indonesian [idin | Nepali ne 
Interlingua la | Norwegian no 
Interlingue ie Occitan oc 
Inuktitut iu Oriya or 
Inupiak ik Oromo (Afan, Galla) om 
Irish [ee | Papiamentu 
Italian Ix | Pashto (Pushto) ps 
Japanese Polish pl 
Javanese Portuguese pt 
Kannada kn Punjabi pa 
Kanuri | | Quechua qu 
Kashmiri Rhaeto-Romance m 
Kazakh Romanian TO 
Kinyarwanda (Ruanda) IW Russian TU 
Kirghiz Sami (Lappish) 
Kirundi (Rundi) Im | Samoan sm 
Konkani Sangro sg 
Korean ko Sanskrit sa 
Kurdish ku Serbian Sr 
Laothian |o | Serbo-Croatian sh 
Latin [a | Sesotho st 
Latvian (Lettish) lv Setswana tn 
Limburgish ( Limburger) li Shona sn 
Lingala In Sindhi sd 
Lithuanian ln | Sinhalese si 
Macedonian Siswati SS 
Malagasy mg Slovak sk 
Malay ms Slovenian sl 
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语 8B ISO Code ISO Code 
Somali so 
Spanish es 
Sundanese su 
Swahili (Kiswahili) sw 
Swedish sv 
Syriac 
Tagalog tl 
Tajik tg Venda 
Tamazight Vietnamese 
Tamil ta Volapuk 
Tatar tt Welsh 
Tibetan bo 
Tigrinya ti yi. ji 
Tsonga ts zu 


